Skip to content

Latest commit

 

History

History
127 lines (89 loc) · 5.46 KB

nf-tspi-tspi_linegeneratedigits.md

File metadata and controls

127 lines (89 loc) · 5.46 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:tspi.TSPI_lineGenerateDigits
TSPI_lineGenerateDigits function (tspi.h)
The TSPI_lineGenerateDigits function initiates the generation of the specified digits on the specified call as in-band tones using the specified signaling mode.
TSPI_lineGenerateDigits
TSPI_lineGenerateDigits function [TAPI 2.2]
_tspi_tspi_linegeneratedigits
tspi.tspi_linegeneratedigits
tspi/TSPI_lineGenerateDigits
tspi\tspi_linegeneratedigits.htm
tapi3
af16a4aa-1682-432b-827f-ae42289d5b99
12/05/2018
TSPI_lineGenerateDigits, TSPI_lineGenerateDigits function [TAPI 2.2], _tspi_tspi_linegeneratedigits, tspi.tspi_linegeneratedigits, tspi/TSPI_lineGenerateDigits
tspi.h
Windows
Windows
19H1
TSPI_lineGenerateDigits
tspi/TSPI_lineGenerateDigits
c++
APIRef
kbSyntax
UserDefined
Tspi.h
TSPI_lineGenerateDigits

TSPI_lineGenerateDigits function

-description

The TSPI_lineGenerateDigits function initiates the generation of the specified digits on the specified call as in-band tones using the specified signaling mode. Invoking this function while digit or tone generation is in progress aborts the current digit or tone generation. Passing a NULL value for lpsDigits generates no new digits.

Note  Only one in-band generation request at a time (tone generation or digit generation) can be in progress per call.
 

-parameters

-param hdCall

The handle to the call on which digit generation is to be done.

-param dwEndToEndID

This unique request identifier should be stored by the service provider and passed back as dwParam2 to the LINEEVENT procedure when the digit generation is completed.

-param dwDigitMode

The format to be used for signaling these digits. This parameter uses one and only one of the LINEDIGITMODE_ constants.

-param lpszDigits

A pointer to a null-terminated Unicode character buffer that contains the digits to be generated. A comma injects an extra delay between the signaling of the previous and next digits it separates. The duration of this pause is configuration defined. The line's device capabilities indicate what this duration is. Multiple commas can be used to inject longer pauses. Invalid digits are ignored during the generation, rather than being reported as an error.

-param dwDuration

Specifies both the duration in milliseconds of DTMF digits and pulse and DTMF inter-digit spacing. A value of 0 uses a default value. The dwDuration parameter must be within the range specified by MinDialParams to MaxDialParams in LINEDEVCAPS. If out of range, the actual value is set by the service provider to the nearest value in the range. This parameter is not validated by TAPI when this function is called.

-returns

Returns zero if the function succeeds or an error number if an error occurs. Possible return values are as follows:

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL, LINEERR_RESOURCEUNAVAIL.

-remarks

The call state of hdCall can be any state.

The TSPI_lineGenerateDigits function is considered to have completed successfully when the digit generation is successfully initiated; not when all digits are generated.

After all digits in lpsDigits are generated, or after digit generation is aborted or canceled, a LINE_GENERATE message is sent to TAPI.

Note  Only one inband generation request (tone generation or digit generation) is allowed to be in progress per call. This implies that if digit generation is currently in progress on a call, invoking either TSPI_lineGenerateDigits or TSPI_lineGenerateTone cancels the digit generation. The service provider must terminate any digit generation in progress when a subsequent TSPI_lineGenerateDigits or TSPI_lineGenerateTone is invoked. Invoking TSPI_lineGenerateDigits with lpszDigits set to NULL cancels any current digit (or tone) generation.
 
The corresponding function at the TAPI level does not include the formal parameter dwEndToEndID. At that level, there is no end-to-end marking. TAPI uses end-to-end marking at the TSPI level to disambiguate one TSPI_lineGenerateDigits request from another.

-see-also

LINEDEVCAPS

LINEDIGITMODE_ Constants

LINEEVENT

LINE_GENERATE

TSPI_lineGenerateTone