NdisMCmOpenAddressFamilyComplete makro (ndis.h)
NdisMCmOpenAddressFamilyComplete gibt die letzte status der Clientanforderung zurück, für die die ProtocolCmOpenAf-Funktion des MCM-Treibers NDIS_STATUS_PENDING zurückgegeben wurde, um die Adressfamilie des MCM-Treibers zu öffnen.
Syntax
void NdisMCmOpenAddressFamilyComplete(
_S_,
_H_,
_C_
);
Parameter
_S_
Gibt den letzten status der Clientanforderung zum Öffnen des AF an, entweder NDIS_STATUS_SUCCESS oder ein beliebiger aufruferbezogener NDIS_STATUS_ XXX außer NDIS_STATUS_PENDING.
_H_
Gibt das von NDIS bereitgestellte Handle an, das für die ProtocolCmOpenAf-Funktion des MCM-Treibers eingegeben wurde, die NDIS_STATUS_PENDING zurückgegeben hat.
_C_
Gibt das Handle für einen vom Aufrufer zugewiesenen residenten Kontextbereich an, in dem der MCM-Treiber den Zustand über das Öffnen dieses Clients der Adressfamilie verwaltet, einschließlich des NdisAfHandle, wenn das Öffnen erfolgreich war. Andernfalls ignoriert NDIS diesen Parameter.
Rückgabewert
Keine
Bemerkungen
Ein MCM-Treiber muss NdisMCmOpenAddressFamilyComplete aufrufen, wenn seine ProtocolCmOpenAf-Funktion zuvor NDIS_STATUS_PENDING für das angegebene NdisAfHandle zurückgegeben hat. Der Client, der den pended open-AF-Vorgang mit einem Aufruf von NdisClOpenAddressFamilyEx initiiert hat, kann keine weiteren verbindungsorientierten Vorgänge für dieselbe Bindung ausführen, bis NdisMCmOpenAddressFamilyComplete einen Aufruf dieses Clients verursacht. ProtocolClOpenAfCompleteEx-Funktion .
Wenn der Aufrufer von NdisMCmOpenAddressFamilyCompleteStatus auf NDIS_STATUS_SUCCESS festlegt, übergibt NDIS anschließend das angegebene CallMgrAfContext-Handle als Eingabeparameter an alle vom MCM-Treiber bereitgestellten Funktionen ProtocolCmXxx und ProtocolCoXxx , die die Öffnung der Adressfamilie des Clients betreffen, bis der Client den AF schließt. Der MCM-Treiber sollte alle zugeordneten AF-Kontextbereiche freigeben oder wiederverwenden, bevor ein Fehler status an NdisMCmOpenAddressFamilyComplete übergeben wird.
Für ein erfolgreiches Öffnen stellt das von NDIS bereitgestellte NdisAfHandle eine Zuordnung zwischen dem MCM-Treiber und dem Client für den geöffneten AF dar. Beide NDIS-Treiber müssen NdisAfHandle als undurchsichtige Variable behandeln, die in nachfolgenden Aufrufen von NdisCl/Co/MCm/MCoXxx-Funktionen übergeben werden soll, für die dieses Handle ein erforderlicher Parameter ist. Bei einem Fehler beim Öffnen sollte der MCM-Treiber die NdisAfHandle als ungültig betrachten, wenn NdisMCmOpenAddressFamilyComplete die Steuerung zurückgibt.
Nur verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, können NdisMCmOpenAddressFamilyComplete aufrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmOpenAddressFamilyComplete auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCmOpenAddressFamilyComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCmOpenAddressFamilyComplete (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |