NdisIMGetDeviceContext-Funktion (ndis.h)
Hinweis NDIS 5. x ist veraltet und wird von NDIS 6 ersetzt. x. Informationen zur neuen NDIS-Treiberentwicklung finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber auf NDIS 6. xfinden Sie unter Portieren von NDIS 5.x-Treibern zu NDIS 6.0.
Mit dieser Funktion kann die MiniportInitialize-Funktion eines NDIS-Zwischentreibers auf den gerätekontextbezogenen Bereich zugreifen, der von der ProtocolBindAdapter--Funktion zugewiesen wird.
Syntax
NDIS_HANDLE NdisIMGetDeviceContext(
[in] NDIS_HANDLE MiniportAdapterHandle
);
Parameter
[in] MiniportAdapterHandle
Gibt die Handleeingabe an, um MiniportInitialize.
Rückgabewert
In der folgenden Tabelle sind die Rückgabewerte für diese Funktion aufgeführt.
| Wert | Beschreibung |
|---|---|
| NDISIMGETDEVICECONTEXT | Gibt den Zugriff auf den Gerätekontextbereich für die virtuelle NIC zurück, die von MiniportAdapterHandleidentifiziert wird. |
| NULL | Wenn die ProtocolBindAdapter-Funktion des Treibers einen solchen Gerätekontextbereich nicht zugewiesen hat. |
Bemerkungen
Die MiniportInitialize- Funktion eines NDIS-Zwischentreibers ruft NdisIMGetDeviceContext auf den Gerätekontextbereich für die virtuelle NIC zuzugreifen, die initialisiert wird. In der Regel wird der Speicher für einen solchen Bereich durch die ProtocolBindAdapter-Funktion des Zwischentreibers bereitgestellt, die NdisImInitializeDeviceInstanceEx mit einem Zeiger auf diesen Bereich aufruft, wodurch die MiniportInitialize-Funktion des Treibers aufgerufen wird. Ein Zwischentreiber ist jedoch nicht erforderlich, um einen solchen Kontextbereich zu haben.
Auf der Rückkehr von NdisIMGetDeviceContext, MiniportInitialize richtet den treiberdefinierte Zustand für die virtuelle NIC mit den Informationen ein, die der Zwischentreiberschreiber für immer noch nützliche Protokolle auf höherer Ebene plant, die sich anschließend an seine virtuelle NIC binden.
Weiterhin höhere NDIS-Protokolle, die an dieselbe virtuelle NIC gebunden sind, können anschließend auf diesen Gerätekontextbereich zugreifen, indem sie NdisIMGetBindingContext aus ihren ProtocolBindAdapter--Funktionen aufrufen.
Betriebssystemversionen: Windows CE .NET 4.0 und höher.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ndis.h |
| Library | Ndis.lib |
| IRQL- | IRQL-<= DISPATCH_LEVEL |