Freigeben über


NdisIMGetBindingContext-Funktion (ndis.h)

Die NdisIMGetBindingContext-Funktion ermöglicht einem NDIS-Protokolltreiber den Zugriff auf den Gerätekontextbereich, der von einem zugrunde liegenden Zwischentreiber erstellt wurde, für einen virtuellen Miniport, an den der Protokolltreiber der höheren Ebene gebunden ist.

Syntax

NDIS_HANDLE NdisIMGetBindingContext(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parameter

[in] NdisBindingHandle

Das Bindungshandle, das die NdisOpenAdapterEx-Funktion am NdisBindingHandle-Parameter zurückgegeben hat, der den virtuellen Miniport des nächstniedrigen Zwischentreibers identifiziert, an den der Aufrufer gebunden ist.

Rückgabewert

NdisIMGetBindingContext gibt ein Handle an den Gerätekontextbereich für den angegebenen virtuellen Miniport zurück, oder es gibt NULL zurück, wenn kein solcher Kontextbereich vorhanden ist.

Hinweise

Ein Protokolltreiber oder Zwischentreiber kann NdisIMGetBindingContext über seine ProtocolBindAdapterEx-Funktion aufrufen, um auf den Gerätekontext für einen virtuellen Miniport zuzugreifen, an den er gebunden ist. Der Gerätekontext stellt einen gemeinsamen Kontextbereich für alle übergeordneten Protokolltreiber bereit, die an denselben zugrunde liegenden Zwischentreiber gebunden sind.

Ein solcher Gerätekontextbereich wurde vom untergeordneten NDIS-Zwischentreiber zugeordnet und definiert und in einem Aufruf an die NDIS übergeben. NdisIMInitializeDeviceInstanceEx-Funktion .

Alle Protokolltreiber, die NdisIMGetBindingContext aufrufen, können sicher davon ausgehen, dass der zugrunde liegende Zwischentreiber seinen Kontextbereich aus einem nicht auslagerungsfreien Pool zugeordnet hat. Sie sollten den zurückgegebenen Kontextbereich als schreibgeschützt behandeln, wobei der Zustand beibehalten wird, der vom zugrunde liegenden NDIS-Zwischentreiber eingerichtet wurde, der ihn definiert hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisIMGetBindingContext (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisIMGetBindingContext (NDIS 5.1)) in Windows XP.
Zielplattform Desktop
Kopfzeile ndis.h (einschließlich Ndis.h)
Bibliothek Ndis.lib
IRQL < DISPATCH_LEVEL
DDI-Complianceregeln Irql_IM_Function(ndis)

Weitere Informationen

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx