NdisCompleteBindAdapterEx-Funktion (ndis.h)
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) |