NdisMCmDeleteVc-Funktion (ndis.h)
NdisMCmDeleteVc zerstört eine vom Anrufer 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 NdisMCmCreateVcabgerufen.
Rückgabewert
NdisMCmDeleteVc- kann eine der folgenden Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
NDIS hat die VC gelöscht. |
|
Der VC ist noch aktiv, sodass er nicht gelöscht werden konnte. |
Bemerkungen
Wenn ein MCM-Treiber NdisMCmDeleteVcaufruft, darf es keine offenen Aufrufe für die angegebene 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 der der Aufrufer die NdisVcHandle teilt.
Wenn NdisMCmDeleteVc Steuerelement zurückgibt, ist die NdisVcHandle- nicht mehr gültig. Der MCM-Treiber kann die Ressourcen freigeben, die ihm zugewiesen wurden, um den Status des gelöschten VC beizubehalten, oder sie für die Wiederverwendung in einer nachfolgenden Benachrichtigung für eingehende Anrufe vorbereiten, nachdem er NdisMCmCreateVcaufgerufen 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 Anrufe aufruft.
Nur verbindungsorientierte Miniporttreiber, die integrierte Anrufverwaltungsunterstützung bieten, können NdisMCmDeleteVc-anrufen. Eigenständige Anrufmanager und -clients, die sich selbst bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCoDeleteVc auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCmDeleteVc (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCmDeleteVc (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |