NdisCmDispatchIncomingCloseCall-Funktion (ndis.h)
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.
void NdisCmDispatchIncomingCloseCall(
[in] NDIS_STATUS CloseStatus,
[in] NDIS_HANDLE NdisVcHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
[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.
Keine
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).
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 .
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) |