Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
NdisMCmOpenAddressFamilyComplete den endgültigen Status einer 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 endgültigen Status der Anforderung des Clients an, den AF zu öffnen, entweder NDIS_STATUS_SUCCESS oder einen anruferbestimmten NDIS_STATUS_ XXX- außer NDIS_STATUS_PENDING.
_H_
Gibt den von NDIS bereitgestellten Handle an, der an die ProtocolCmOpenAf--Funktion des MCM-Treibers eingegeben wurde, die NDIS_STATUS_PENDING zurückgegeben hat.
_C_
Gibt das Handle für einen vom Anrufer zugewiesenen Resident-Kontextbereich an, in dem der MCM-Treiber den Status über das Öffnen der Adressfamilie dieses Clients verwaltet, einschließlich der NdisAfHandle-, wenn das Öffnen erfolgreich war. Andernfalls ignoriert NDIS diesen Parameter.
Rückgabewert
Nichts
Bemerkungen
Ein MCM-Treiber muss NdisMCmOpenAddressFamilyComplete- aufrufen, wenn die ProtocolCmOpenAf-Funktion zuvor NDIS_STATUS_PENDING für die angegebene NdisAfHandle- zurückgegeben wurde. Der Client, der den pended open-AF-Vorgang mit einem Aufruf von NdisClOpenAddressFamilyExinitiiert hat, kann keine weiteren verbindungsorientierten Vorgänge für dieselbe Bindung ausführen, bis NdisMCmOpenAddressFamilyComplete einen Aufruf an diesen Client verursacht ProtocolClOpenAfCompleteEx--Funktion.
Wenn der Aufrufer von NdisMCmOpenAddressFamilyCompleteStatus auf NDIS_STATUS_SUCCESS festlegt, NDIS übergibt anschließend die angegebene CallMgrAfContext- als Eingabeparameter an alle vom MCM treiber bereitgestellten ProtocolCm-Xxx-- und ProtocolCo-Xxx--Funktionen, die das Öffnen 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 Fehlerstatus an NdisMCmOpenAddressFamilyCompleteübergeben wird.
Bei einem erfolgreichen Öffnen stellt die 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 übergeben, unverändert und nicht interpretiert werden soll, in nachfolgenden Aufrufen von NdisCl/Co/MCm/MCoXxx-Funktionen, für die dieses Handle ein erforderlicher Parameter ist. Bei einem fehlgeschlagenen Öffnen sollte der MCM-Treiber die NdisAfHandle- ungültig betrachten, wenn NdisMCmOpenAddressFamilyComplete die Steuerung zurückgibt.
Nur verbindungsorientierte Miniporttreiber, die integrierte Anrufverwaltungsunterstützung bieten, können NdisMCmOpenAddressFamilyCompleteanrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmOpenAddressFamilyComplete auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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 |
| Header- | ndis.h (include Ndis.h) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |