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 an der NdisBindingHandle Parameter zurückgegeben, der den virtuellen Miniport des nächsten unteren Zwischentreibers identifiziert, an den der Aufrufer gebunden ist.

Rückgabewert

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

Bemerkungen

Ein Protokolltreiber oder Zwischentreiber kann NdisIMGetBindingContext- aus seiner 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 übermäßigen Protokolltreiber bereit, die an den gleichen zugrunde liegenden Zwischentreiber gebunden sind.

Ein solcher Gerätekontextbereich wurde vom NDIS-Zwischentreiber der unteren Ebene zugewiesen und in einem Aufruf an NDIS übergeben. NdisIMInitializeDeviceInstanceEx Funktion.

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

Anforderungen

Siehe auch

NdisOpenAdapterEx

ProtocolBindAdapterEx-