NdisCmCloseCallComplete-Funktion (ndis.h)
NdisCmCloseCallComplete den endgültigen Status der Anforderung eines Kunden 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 die CM die Verbindung schließt, entweder NDIS_STATUS_SUCCESS oder ein CM-bestimmter NDIS_STATUS_XXX- außer NDIS_STATUS_PENDING.
[in] NdisVcHandle
Gibt das Handle für den Anruf an. Dieses Handle wurde von NDIS bereitgestellt, als die VC ursprünglich erstellt wurde, ob vom Anrufmanager oder Client, mit NdisCoCreateVc. Vor kurzem hat der Anrufmanager dieses Handle aus dem pro VC-Zustand abgerufen, der vom CallMgrVcContext als Eingabeparameter an seinen ProtocolCmCloseCall-Funktion.
[in, optional] NdisPartyHandle
Gibt entweder NULL- an, wenn die NdisVcHandle- einen Punkt-zu-Punkt-VC-Wert darstellt, oder das Handle an die letzte verbleibende Partei in einer Multipointverbindung, die der CM aus seinem durch den CallMgrPartyContext als Eingabeparameter an seine ProtocolCmCloseCall--Funktion übergeben.
Rückgabewert
Nichts
Bemerkungen
Wenn die ProtocolCmCloseCall-Funktion eines eigenständigen Anrufmanagers NDIS_STATUS_PENDING zurückgibt, muss der CM NdisCmCloseCallComplete anschließend aufrufen, um den Client und NDIS darüber zu benachrichtigen, dass der Versuch, die Verbindung zu unterbrechen, erfolgreich oder mit einem Fehler beendet wurde. Ein Aufruf von NdisCmCloseCallComplete bewirkt, dass NDIS den Client aufruft ProtocolClCloseCallComplete-Funktion.
Wenn sie NDIS_STATUS_SUCCESS als Status-übergeben wird, sollte der Anrufmanager die NdisVcHandle- (und NdisPartyHandle, falls vorhanden) für Übertragungen über das Netzwerk nicht verwendet werden können, sobald es NdisCmCloseCallCompleteaufruft. Wenn der Anrufmanager ursprünglich den VC 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 Anruf-Manager einen Aufruf seiner ProtocolCoDeleteVc--Funktion mit der Funktion "ProtocolCoDeleteVc" erwarten.
ProtocolVcContext-, wobei es dieselbe NdisVcHandle-als Eingabeparameter aufweist.
Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmCloseCallCompleteaufrufen. Verbindungsorientierte Miniporttreiber, die stattdessen integrierte Anrufverwaltungsunterstützung NdisMCmCloseCallComplete bereitstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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 |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_CallManager_Function(ndis) |