Syntax | void TSPI_phoneSetCompletionCallback(dwTSPIVersion, cbCompletion) This procedure sets the procedure pointer to be used for all asynchronous request completion callbacks for "phone" requests to the service provider. |
Parameters | DWORD dwTSPIVersion Specifies the overall interface version that has been negotiated using TSPI_phoneNegotiateTSPIVersion. |
ASYNC_PHONE_COMPLETION cbCompletion Specifies the far pointer to the procedure to be called to report completion of all phone-related functions for all phone devices supported by the Service Provider. | |
Return Value | none |
Call States | Not applicable |
Comments | Since this procedure is called without an active device to identify the interface version, it includes an already-negotiated TSPI version number defining the interface version at which the Service Provider is expected to operate for this function. An "early" version negotiation such as this uses the dwDeviceID value INITIALIZE_NEGOTIATE to signify that an overall interface version number is being negotiated. |
The operation is always synchronous, with presumed success. | |
Comparison | This procedure has no direct corresondence at the TAPI level, where completion of asynchronous operations is reported by sending a message to a central callback function where all other messgas are reported. |
See Also | Functions: TSPI_phoneNegotiateTSPIVersion Constants: INITIALIZE_NEGOTIATE |