ASYNC_COMPLETION Rückruffunktion (tspi.h)
Completion_Proc ist eine Rückruffunktion, die von TAPI implementiert und dem Dienstanbieter als Parameter für TSPI_providerInit bereitgestellt wird. Der Dienstanbieter ruft diese Funktion auf, um den Abschluss einer Leitungs- oder Telefonprozedur zu melden, die asynchron ausgeführt wird.
Der ASYNC_COMPLETION-Typs definiert einen Zeiger auf diese Rückruffunktion. Completion_Proc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
ASYNC_COMPLETION AsyncCompletion;
void AsyncCompletion(
DRV_REQUESTID dwRequestID,
LONG lResult
)
{...}
Parameter
dwRequestID
Der Bezeichner, der in der ursprünglichen Anforderung übergeben wurde, die der Dienstanbieter asynchron ausgeführt hat.
lResult
Das Ergebnis des Vorgangs. Dies kann null sein, um einen Erfolg anzuzeigen, oder eine negative Zahl, die auf einen Fehler hinweist. Die möglichen spezifischen Fehlerwerte, die sich aus einer Funktion ergeben können, sind für die asynchrone oder synchrone Ausführung identisch.
Rückgabewert
Keine
Bemerkungen
Der Aufrufzustand beim Aufrufen dieser Funktion kann ein beliebiger Zustand sein.
Diese Prozedur wird von TAPI bereitgestellt, wenn ein Dienstanbieter mit der TSPI_providerInit-Funktion initialisiert wird. Einige der TSPI-Prozeduren, die Online-, Anruf- und Telefongeräte betreiben, geben den asynchronen Betrieb an. Diese Prozeduren umfassen einen dwRequestID-Parameter , um die Anforderung zu identifizieren. Wenn eine solche Prozedur aufgerufen wird, kann der Dienstanbieter eine negative Zahl für einen Fehler zurückgeben, wenn eine sofort erkannt wird, oder die positive dwRequestID , wenn der Vorgang asynchron fortgesetzt wird. Der Dienstanbieter muss für jede Anforderung, die er asynchron ausführt, den Abschluss genau einmal melden. Dazu wird diese Prozedur aufgerufen. Der Dienstanbieter darf diese Prozedur oder die Line_Event oder Phone_Event Prozedur erst erneut aufrufen, wenn diese Prozedur zurückgegeben wird.
Der Dienstanbieter darf die Completion_Proc-Funktion aufrufen, bevor sie von der ersten Anforderung zurückgegeben wird. TAPI garantiert, dass der Dienstanbieter nicht innerhalb des Completion_Proc Kontexts aufgerufen wird , es sei denn, es wird darauf hingewiesen.
Dies weist keine direkte Korrespondenz auf TAPI-Ebene auf, da auf dieser Ebene asynchrone Funktionsvervollständigungen als Nachricht gemeldet werden, die über dieselbe Rückrufschnittstelle übergeben wird, die für spontane Ereignismeldungen verwendet wird. Auf TSPI-Ebene werden spontane Ereignisse über die Line_Event - und Phone_Event Rückrufprozeduren gemeldet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |