PROTOCOL_CM_INCOMING_CALL_COMPLETE Rückruffunktion (ndis.h)

Artikel
03/05/2024

Die ProtocolCmIncomingCallComplete-Funktion ist erforderlich. Wenn NDIS diese Funktion aufruft, gibt ProtocolCmIncomingCallComplete dem Anruf-Manager an, dass der verbindungsorientierte Client die Verarbeitung eines eingehenden Anrufangebots abgeschlossen hat, das der Anrufmanager zuvor über NdisCmDispatchIncomingCall.

Hinweis Sie müssen die Funktion mit dem typ PROTOCOL_CM_INCOMING_CALL_COMPLETE deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt Beispiele.

Syntax

PROTOCOL_CM_INCOMING_CALL_COMPLETE ProtocolCmIncomingCallComplete;

void ProtocolCmIncomingCallComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE CallMgrVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

Parameter

[in] Status

Gibt die endgültige status des Vorgangs an, um einen eingehenden Aufruf an einen verbindungsorientierten Client zu senden.

[in] CallMgrVcContext

Gibt das Handle für einen vom Anruf-Manager zugeordneten Kontextbereich an, in dem der Anruf-Manager seinen Status pro Vc verwaltet. Der Aufruf-Manager hat dieses Handle über seine ProtocolCoCreateVc-Funktion bereitgestellt.

[in] CallParameters

Zeiger auf die Aufrufparameter, wie vom Anruf-Manager im Aufruf von NdisCmDispatchIncomingCall angegeben. Das Signalisierungsprotokoll bestimmt, welche Aufrufparameter der Anruf-Manager ändern kann, falls vorhanden.

Rückgabewert

Keine

Bemerkungen

Wenn der verbindungsorientierte Client die Verarbeitung eines eingehenden Verbindungsangebots abgeschlossen hat, das der Anruf-Manager an ihn weitergeleitet hat, wird diese Routine aufgerufen, wenn NdisCmDispatchIncomingCall NDIS_STATUS_PENDING zurückgegeben hat. Die endgültige status des eingehenden Anrufs finden Sie unter Status. Mögliche Werte für Status umfassen, sind jedoch nicht beschränkt auf:

Wenn der Client den eingehenden Anruf akzeptiert, sollte der Anrufmanager Signalnachrichten senden, um der aufrufenden Entität mitzuteilen, dass der Anruf akzeptiert wurde. Wenn der Client den Anruf nicht annimmt, sollte der Anruf-Manager Signalnachrichten senden, um anzugeben, dass der Anruf abgelehnt wurde.

Beispiele

Um eine ProtocolCmIncomingCallComplete-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der zu definierenden Funktion identifiziert. Windows bietet eine Reihe von Funktionstypen für Treiber. Das Deklarieren einer Funktion mithilfe der Funktionstypen hilft der Codeanalyse für Treiber, der statischen Treiberüberprüfung (Static Driver Verifier , SDV) und anderen Überprüfungstools, Fehler zu finden, und es ist eine Voraussetzung für das Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine ProtocolCmIncomingCallComplete-Funktion mit dem Namen "MyCmIncomingCallComplete" zu definieren, verwenden Sie den typ PROTOCOL_CM_INCOMING_CALL_COMPLETE , wie in diesem Codebeispiel gezeigt:

PROTOCOL_CM_INCOMING_CALL_COMPLETE MyCmIncomingCallComplete;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyCmIncomingCallComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  CallMgrVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

Der PROTOCOL_CM_INCOMING_CALL_COMPLETE Funktionstyp ist in der Headerdatei Ndis.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, müssen Sie der Funktionsdefinition die anmerkung Use_decl_annotations hinzufügen. Die Use_decl_annotations-Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den PROTOCOL_CM_INCOMING_CALL_COMPLETE Funktionstyp in der Headerdatei angewendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.

Informationen zu Use_decl_annotations finden Sie unter Verhalten von Funktionen mit Anmerkungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe ProtocolCmIncomingCallComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe ProtocolCmIncomingCallComplete (NDIS 5.1)) in Windows XP.
Zielplattform	Windows
Kopfzeile	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

NdisCmDispatchIncomingCall

ProtocolClIncomingCall

ProtocolCmRegisterSap

Freigeben über