NdisMCmDropPartyComplete-Makro (ndis.h)
NdisMCmDropPartyComplete gibt die letzte status der Clientanforderung zurück, für die der MCM-Treiber zuvor NDIS_STATUS_PENDING zurückgegeben hat, um eine Partei aus einer Mehrpunkt-VC zu entfernen.
Syntax
void NdisMCmDropPartyComplete(
_S_,
_H_
);
Parameter
_S_
Gibt den endgültigen status des angeforderten Vorgangs an, entweder NDIS_STATUS_SUCCESS oder ein vom Aufrufer bestimmtes NDIS_STATUS_ XXX außer NDIS_STATUS_PENDING.
_H_
Gibt das Handle für die Partei an, die vom Client angefordert wurde, gelöscht werden. Der MCM-Treiber hat dieses Handle aus seinem von CallMgrPartyContext definierten Statusbereich pro Partei abgerufen, der als Eingabeparameter an seinen übergeben wurde. ProtocolCmDropParty-Funktion .
Rückgabewert
Keine
Bemerkungen
Ein MCM-Treiber muss NdisMCmDropPartyComplete aufrufen, wenn seine ProtocolCmDropParty-Funktion zuvor NDIS_STATUS_PENDING für den angegebenen NdisPartyHandle zurückgegeben hat. Weder NDIS noch der Client, der den Pended Drop-Party-Vorgang mit einem Aufruf von NdisClDropParty initiiert hat, können die Ressourcen freigeben, die sie zugewiesen haben, um den Status pro Partei aufrechtzuerhalten, bis der Aufruf des MCM-Treibers an NdisMCmDropPartyComplete einen Aufruf dieses Clients auslöst. ProtocolClDropPartyComplete-Funktion .
Wenn NDIS_STATUS_SUCCESS für den Status übergeben wird, muss der MCM-Treiber das NdisPartyHandle als ungültig betrachten, wenn NdisMCmDropPartyComplete die Steuerung zurückgibt. Der MCM-Treiber kann alle Ressourcen freigeben (oder zur Wiederverwendung neu initialisieren), die er zugewiesen hat, um den Zustand für diese Partei aufrechtzuerhalten, nachdem NdisMCmDropPartyComplete die Steuerung zurückgegeben hat.
Nur verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, können NdisMCmDropPartyComplete aufrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmDropPartyComplete auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCmDropPartyComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCmDropPartyComplete (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |