NdisCmOpenAddressFamilyComplete-Funktion (ndis.h)
NdisCmOpenAddressFamilyComplete den endgültigen Status eines eigenständigen Anrufmanagers für einen bestimmten Client zurückgibt, nachdem der Anrufmanager als Antwort auf die ursprüngliche Open-AF-Anforderung dieses Clients NDIS_STATUS_PENDING zurückgegeben hat.
Syntax
void NdisCmOpenAddressFamilyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisAfHandle,
[in] NDIS_HANDLE CallMgrAfContext
);
Parameter
[in] Status
Gibt den endgültigen Status des Open-AF-Vorgangs an, entweder NDIS_STATUS_SUCCESS oder einen CM-ermittelten Fehler NDIS_STATUS_ XXX- außer NDIS_STATUS_PENDING.
[in] NdisAfHandle
Gibt das von NDIS bereitgestellte Handle an, das an die ProtocolCmOpenAf-Funktion des Anruf-Managers übergeben wurde, die NDIS_STATUS_PENDING zurückgegeben hat.
[in] CallMgrAfContext
Gibt das Handle für einen vom Anrufer zugewiesenen Resident-Kontextbereich an, in dem der Anrufmanager den Status über das Öffnen der Adressfamilie dieses Clients verwaltet, einschließlich der NdisAfHandle-, wenn das Öffnen erfolgreich war. Wenn Status- nicht NDIS_STATUS_SUCCESS ist, ignoriert NDIS diesen Parameter.
Rückgabewert
Nichts
Bemerkungen
Ein eigenständiger Anruf-Manager muss NdisCmOpenAddressFamilyComplete- 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 NdisCmOpenAddressFamilyComplete einen Aufruf an diesen Client verursacht ProtocolClOpenAfCompleteEx--Funktion.
Wenn der Aufrufer von NdisCmOpenAddressFamilyCompleteStatus auf NDIS_STATUS_SUCCESS festlegt, NDIS übergibt anschließend die angegebene CallMgrAfContext- als Eingabeparameter an alle cm-bereitgestellten ProtocolCm-Xxx und ProtocolCo-Xxx--Funktionen, die das Öffnen der Adressfamilie des Clients betreffen, bis der Client den AF schließt. Der Anrufmanager sollte alle zugeordneten AF-Kontextbereiche freigeben oder wiederverwenden, bevor ein Fehlerstatus an NdisCmOpenAddressFamilyCompleteübergeben wird.
Bei einem erfolgreichen Öffnen stellt die von NDIS bereitgestellte NdisAfHandle eine Zuordnung zwischen dem Anrufmanager und dem Client für den geöffneten AF auf einem bestimmten Miniporttreiber dar, an den der Anrufmanager und der Client gebunden sind. Beide Protokolltreiber müssen NdisAfHandle- als undurchsichtige Variable behandeln, die in nachfolgenden Aufrufen von NdisCl/Cm/CoXxx-Funktionen übergeben wird, für die dieser Handle ein erforderlicher Parameter ist. Bei einem fehlgeschlagenen Öffnen sollte der Anrufmanager die NdisAfHandle ungültig betrachten, wenn NdisMCmOpenAddressFamilyComplete die Steuerung zurückgibt.
Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmOpenAddressFamilyCompleteaufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Anrufverwaltungsunterstützung bieten, müssen anrufen stattdessen NdisMCmOpenAddressFamilyComplete.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCmOpenAddressFamilyComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCmOpenAddressFamilyComplete (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_CallManager_Function(ndis) |