NdisCompleteBindAdapterEx-Funktion (ndis.h)

  • Artikel

Ein Protokolltreiber ruft die NdisCompleteBindAdapterEx-Funktion auf, um einen Bindungsvorgang abzuschließen, für den die ProtocolBindAdapterEx-Funktion des Treibers NDIS_STATUS_PENDING zurückgegeben wurde.

Syntax

void NdisCompleteBindAdapterEx(
       NDIS_HANDLE BindAdapterContext,
  [in] NDIS_STATUS Status
);

Parameter

BindAdapterContext

Das Handle, das NDIS an den BindContext-Parameter des ProtocolBindAdapterEx-Funktion .

[in] Status

Der letzte status des abgeschlossenen Bindungsvorgangs. Dieser Parameter kann einer der folgenden Werte sein:

NDIS_STATUS_SUCCESS

Der Treiber hat die Bindung an die zugrunde liegende NIC erfolgreich abgeschlossen.

NDIS_STATUS_XXX oder NTSTATUS_XXX

Der Versuch des Protokolltreibers, eine Bindung einzurichten, ist fehlgeschlagen, oder der Protokolltreiber konnte die Ressourcen nicht zuordnen, die er für die Ausführung von Netzwerk-E/A-Vorgängen benötigt. Normalerweise wird ein solcher Fehler status von einer NdisXxx-Funktion oder einer Kernelmodusunterstützungsroutine weitergegeben.

Rückgabewert

Keine

Bemerkungen

Wenn ein Protokolltreiber NDIS_STATUS_PENDING von seiner ProtocolBindAdapterEx-Funktion zurückgibt, muss dieser Treiber NdisCompleteBindAdapterEx aufrufen, nachdem der Bindungsvorgang abgeschlossen ist.

Wenn der geöffnete Vorgang erfolgreich war, ist der Protokolltreiber bereit, Hinweise von zugrunde liegenden Treibern zu empfangen und Sendeanforderungen und OID-Anforderungen für die Bindung zu initiieren. Wenn der Treiber NdisCompleteBindAdapterEx mit einem Fehler status aufruft, ist der Bindungsversuch fehlgeschlagen, und der Treiber hat alle Ressourcen freigegeben, die ihm zum Einrichten der Bindung zugewiesen wurden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Desktop
Kopfzeile ndis.h (einschließlich Ndis.h)
Bibliothek Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln Irql_Protocol_Driver_Function(ndis)

Weitere Informationen

NdisOpenAdapterEx

ProtocolBindAdapterEx