NdisCmDispatchIncomingCloseCall-Funktion (ndis.h)

Artikel
04/03/2024

NdisCmDispatchIncomingCloseCall weist einen Client an, einen aktiven oder angebotenen Anruf abreißen, in der Regel, weil der Anrufmanager eine Anforderung vom Netzwerk zum Schließen der Verbindung erhalten hat.

Syntax

void NdisCmDispatchIncomingCloseCall(
  [in]           NDIS_STATUS CloseStatus,
  [in]           NDIS_HANDLE NdisVcHandle,
  [in, optional] PVOID       Buffer,
  [in]           UINT        Size
);

Parameter

[in] CloseStatus

Gibt einen cm-bestimmten NDIS_STATUS_XXX an, der den Grund für die Verbindungsanforderung angibt. Während des normalen Netzwerkbetriebs übergibt ein Anrufmanager NDIS_STATUS_SUCCESS, um anzugeben, dass er eine von der Remotepartei initiierte Anforderung zum Schließen eines aktiven Anrufs erhalten hat.

[in] NdisVcHandle

Gibt das Handle für den Vc des Aufrufs an, der getrennt wird. Dieses Handle wurde von NDIS bereitgestellt, als die Vc ursprünglich mit NdisCoCreateVc erstellt wurde, sei es vom Anruf-Manager oder Client.

[in, optional] Buffer

Zeiger auf einen vom Aufrufer zugewiesenen residenten Puffer, der ggf. zusätzliche protokollspezifische Trenndaten enthält. Abhängig vom zugrunde liegenden Medium kann dieser Zeiger NULL sein.

[in] Size

Gibt die Größe des Puffers in Byte an, null, wenn BufferNULL ist.

Rückgabewert

Keine

Bemerkungen

Bei normalen Netzwerkvorgängen ruft ein eigenständiger CM NdisCmDispatchIncomingCloseCall auf, wobei closeStatus auf NDIS_STATUS_SUCCESS festgelegt ist, da der entsprechende Client auf dem Remoteknoten NdisClCloseCall aufgerufen hat.

Ein Anrufmanager kann jedoch auch NdisCmDispatchIncomingCloseCall aufrufen, wenn eine der folgenden Aktionen auftritt:

Der Anrufmanager hat einen Kunden über ein angebot für eingehende Anrufe benachrichtigt. Wenn der CM's Die ProtocolCmIncomingCallComplete-Funktion wird mit der Zustimmung des Clients aufgerufen. Sie überprüft die Eingabeaufrufparameter, die dieser Client geändert hat. ProtocolCmIncomingCallComplete bestimmt, dass der Client nicht unterstützte Aufrufparameter für die Verbindung vorschlägt, sodass NdisCmDispatchIncomingCloseCall aufgerufen wird.
Ungewöhnliche Netzwerkbedingungen zwingen den Anrufmanager, aktive Anrufe abzunehmen. Wenn beispielsweise der Anruf-Manager benachrichtigt wird, wenn eine Verbindung zwischen diesem Client und der Remotepartei zur Verbindung ausfällt, ruft der CM NdisCmDispatchIncomingCloseCall auf, um zu verhindern, dass der Client weitere Datenübertragungen bei einer solchen unterbrochenen Verbindung versucht (oder erwartet).

Nachdem er jeden Anruf abgebrochen hat, ist der ursprüngliche Ersteller des Vc für den Aufruf von NdisCoDeleteVc verantwortlich, nachdem er alle zusätzlichen Ressourcen freigegeben hat, die er mit dem Vc verknüpft hatte.

Ein Aufruf von NdisCmDispatchIncomingCloseCall bewirkt, dass NDIS die des Clients aufruft. ProtocolClIncomingCloseCall-Funktion .

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingCloseCall aufrufen. Verbindungsorientierte Miniporttreiber, die Anrufverwaltungsunterstützung bereitstellen Stattdessen NdisMCmDispatchIncomingCall .

Anforderungen

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