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) |