NdisCmCloseCallComplete-Funktion (ndis.h)
NdisCmCloseCallComplete gibt die letzte status der Anforderung eines Clients zurück, für die der Anrufmanager zuvor NDIS_STATUS_PENDING zurückgegeben hat, um einen Anruf abreißen zu können.
Syntax
void NdisCmCloseCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in, optional] NDIS_HANDLE NdisPartyHandle
);
Parameter
[in] Status
Gibt den endgültigen status der Anforderung des Clients an, dass der CM die Verbindung schließt, entweder NDIS_STATUS_SUCCESS oder ein von CM festgelegter NDIS_STATUS_XXX außer NDIS_STATUS_PENDING.
[in] NdisVcHandle
Gibt das Handle für den Vc für den Aufruf an. Dieses Handle wurde von NDIS bereitgestellt, als die Vc ursprünglich mit NdisCoCreateVc erstellt wurde, sei es vom Anruf-Manager oder Client. In jüngerer Zeit hat der Anruf-Manager dieses Handle aus seinem status pro VC abgerufen, der vom CallMgrVcContext als Eingabeparameter an seine ProtocolCmCloseCall-Funktion .
[in, optional] NdisPartyHandle
Gibt entweder NULL an, wenn NdisVcHandle eine Punkt-zu-Punkt-VC darstellt, oder das Handle für die letzte verbleibende Partei in einer Mehrpunktverbindung, die der CM aus seinem parteispezifischen Zustand abgerufen hat, der von callMgrPartyContext als Eingabeparameter an seine ProtocolCmCloseCall-Funktion übergeben wird.
Rückgabewert
Keine
Bemerkungen
Wenn die ProtocolCmCloseCall-Funktion eines eigenständigen Aufruf-Managers NDIS_STATUS_PENDING zurückgibt, muss der CM anschließend NdisCmCloseCallComplete aufrufen, um den Client und NDIS darüber zu informieren, dass der Versuch, die Verbindung zu unterbrechen, erfolgreich oder mit einem Fehler abgeschlossen wurde. Ein Aufruf von NdisCmCloseCallComplete bewirkt, dass NDIS die des Clients aufruft. ProtocolClCloseCallComplete-Funktion .
Wenn NDIS_STATUS_SUCCESS als Status übergeben wird, sollte der Anrufmanager NdisVcHandle (und NdisPartyHandle, falls vorhanden) für Übertragungen über das Netzwerk als unbrauchbar betrachten, sobald er NdisCmCloseCallComplete aufruft. Wenn der Anrufmanager die Vc ursprünglich erstellt hat, sollte er NdisCoDeleteVc mit demselben NdisVcHandle aufrufen, den er gerade an NdisCmCloseCallComplete übergeben hat. Wenn der Client diese Vc erstellt hat, kann der Aufruf-Manager einen Aufruf seiner ProtocolCoDeleteVc-Funktion mit der
ProtocolVcContext, wobei es über denselben NdisVcHandle als Eingabeparameter verfügt.
Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmCloseCallComplete aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, rufen stattdessen NdisMCmCloseCallComplete an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCmCloseCallComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCmCloseCallComplete (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) |