NdisCompleteBindAdapterEx-Funktion (ndis.h)
Ein Protokolltreiber ruft die funktion NdisCompleteBindAdapterEx 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, die zum Ausführen von Netzwerk-E/A-Vorgängen erforderlich sind, nicht zuordnen. In der Regel wird ein solcher Fehlerstatus von einer NdisXxx--Funktion oder einer Kernelmodusunterstützungsroutine weitergegeben.
Rückgabewert
Nichts
Bemerkungen
Wenn ein Protokolltreiber NDIS_STATUS_PENDING von seiner ProtocolBindAdapterEx--Funktion zurückgibt, muss dieser Treiber NdisCompleteBindAdapterEx aufrufen, nachdem der Bindungsvorgang abgeschlossen wurde.
Wenn der öffnende Vorgang erfolgreich war, kann der Protokolltreiber Anzeigen von zugrunde liegenden Treibern akzeptieren und Senden von Anforderungen und OID-Anforderungen für die Bindung initiieren. Wenn der Treiber NdisCompleteBindAdapterEx- mit einem Fehlerstatus aufruft, ist der Bindungsversuch fehlgeschlagen, und der Treiber hat alle Ressourcen freigegeben, die der Bindung zugeordnet wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |