NdisMCmDeleteVc-Funktion (ndis.h)

NdisMCmDeleteVc zerstört eine vom Aufrufer erstellte VC.

Syntax

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parameter

[in] NdisVcHandle

Gibt den Handle an, der die zu löschende VC identifiziert. Der Aufrufer hat dieses Handle ursprünglich von NdisMCmCreateVc abgerufen.

Rückgabewert

NdisMCmDeleteVc kann eine der folgenden Aktionen zurückgeben:

Hinweise

Wenn ein MCM-Treiber NdisMCmDeleteVc aufruft, darf es keine ausstehenden Aufrufe für den angegebenen VC geben, und diese VC muss deaktiviert worden sein. Um diese Anforderungen zu erfüllen, bedeutet, dass der MCM-Treiber bereits NdisMCmDeactivateVc mit dem angegebenen NdisVcHandle erfolgreich aufgerufen hat.

Nur der Treiber, der eine bestimmte VC erstellt hat, kann diese VC löschen. Ein Aufruf von NdisMCmDeleteVc bewirkt, dass NDIS die ProtocolCoDeleteVc-Funktion des Clients aufruft, mit dem der Aufrufer NdisVcHandle gemeinsam verwendet .

Wenn NdisMCmDeleteVc das Steuerelement zurückgibt, ist NdisVcHandle nicht mehr gültig. Der MCM-Treiber kann die Ressourcen freigeben, die er zugewiesen hat, um den Zustand über die gelöschte VC beizubehalten, oder sie für die Wiederverwendung in einer nachfolgenden Benachrichtigung für eingehende Anrufe vorbereiten, nachdem er NdisMCmCreateVc aufgerufen hat.

Der Treiberschreiber bestimmt, ob ein MCM-Treiber über eine (interne) MiniportCoDeleteVc-Funktion verfügt, die der Treiber im Kontext des Abreißens von Verbindungen für ausgehende und eingehende Aufrufe aufruft.

Nur verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, können NdisMCmDeleteVc aufrufen. Eigenständige Anrufmanager und -clients, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCoDeleteVc auf.

Anforderungen

Weitere Informationen

MiniportCoDeleteVc

NdisClCloseCall

NdisCoDeleteVc

NdisMCmCreateVc

NdisMCmDeactivateVc

ProtocolCoDeleteVc