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:
| Rückgabecode | Beschreibung |
|---|---|
|
NDIS hat die VC gelöscht. |
|
Die VC ist weiterhin aktiv, sodass sie nicht gelöscht werden konnte. |
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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (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 |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |