NdisCmOpenAddressFamilyComplete-Funktion (ndis.h)

Artikel
08/07/2023

NdisCmOpenAddressFamilyComplete gibt die letzte status des Öffnens eines bestimmten Af-Zugriffs durch einen eigenständigen Anrufmanager für einen bestimmten Client zurück, 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 letzten status des Open-AF-Vorgangs an, entweder NDIS_STATUS_SUCCESS oder ein beliebiger cm-ermittelter Fehler NDIS_STATUS_ XXX außer NDIS_STATUS_PENDING.

[in] NdisAfHandle

Gibt das von NDIS bereitgestellte Handle an, das für die ProtocolCmOpenAf-Funktion des Aufruf-Managers eingegeben wurde, die NDIS_STATUS_PENDING zurückgegeben hat.

[in] CallMgrAfContext

Gibt das Handle für einen vom Anrufer zugewiesenen residenten Kontextbereich an, in dem der Anruf-Manager den Zustand über das Öffnen dieses Clients in der Adressfamilie verwaltet, einschließlich des NdisAfHandle, wenn das öffnen erfolgreich war. Wenn Status nicht NDIS_STATUS_SUCCESS ist, ignoriert NDIS diesen Parameter.

Rückgabewert

Keine

Bemerkungen

Ein eigenständiger Anruf-Manager muss NdisCmOpenAddressFamilyComplete aufrufen, wenn seine ProtocolCmOpenAf-Funktion zuvor NDIS_STATUS_PENDING für die 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 NdisCmOpenAddressFamilyComplete einen Aufruf dieses Clients verursacht. ProtocolClOpenAfCompleteEx-Funktion .

Wenn der Aufrufer von NdisCmOpenAddressFamilyCompleteStatus auf NDIS_STATUS_SUCCESS festlegt, übergibt NDIS das angegebene CallMgrAfContext-Handle anschließend als Eingabeparameter an alle von CM bereitgestellten Funktionen ProtocolCmXxx und ProtocolCoXxx , die das Öffnen der Adressfamilie des Clients betreffen, bis der Client den AF schließt. Der Anruf-Manager sollte alle AF-Kontextbereiche freigeben oder wiederverwenden, die er zugewiesen hat, bevor er einen Fehler status an NdisCmOpenAddressFamilyComplete übergibt.

Für ein erfolgreiches Öffnen stellt das von NDIS bereitgestellte NdisAfHandle eine Zuordnung zwischen dem Anruf-Manager und dem Client für den geöffneten AF für einen bestimmten Miniporttreiber dar, an den der Anruf-Manager und der Client gebunden sind. Beide Protokolltreiber müssen NdisAfHandle als undurchsichtige Variable behandeln, die in nachfolgenden Aufrufen von NdisCl/Cm/CoXxx-Funktionen übergeben werden soll, für die dieses Handle ein erforderlicher Parameter ist. Bei einem fehlerlosen Öffnen sollte der Anruf-Manager die NdisAfHandle als ungültig betrachten, wenn NdisMCmOpenAddressFamilyComplete die Steuerung zurückgibt.

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmOpenAddressFamilyComplete aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, müssen aufrufen Stattdessen NdisMCmOpenAddressFamilyComplete .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (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
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_CallManager_Function(ndis)