NdisIMGetDeviceContext-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x ist veraltet und wird durch NDIS 6 ersetzt. x. Informationen zur Entwicklung neuer NDIS-Treiber finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber für NDIS 6. x, siehe Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

Mit dieser Funktion kann die MiniportInitialize-Funktion eines NDIS-Zwischentreibers auf den Gerätekontextbereich zugreifen, der von der ProtocolBindAdapter-Funktion zugeordnet ist.

Syntax

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parameter

[in] MiniportAdapterHandle

Gibt die Handle-Eingabe für MiniportInitialize an.

Rückgabewert

Die folgende Tabelle zeigt die Rückgabewerte für diese Funktion.

Wert BESCHREIBUNG
NDISIMGETDEVICECONTEXT Gibt den Zugriff auf den Gerätekontextbereich für die durch MiniportAdapterHandle identifizierte virtuelle NIC zurück.
NULL Wenn die ProtocolBindAdapter-Funktion des Treibers einen solchen Gerätekontextbereich nicht zugeordnet hat.

Hinweise

Die MiniportInitialize-Funktion eines NDIS-Zwischentreibers ruft NdisIMGetDeviceContext auf, um auf den Gerätekontextbereich für die virtuelle NIC zuzugreifen, die initialisiert wird. Normalerweise wird der Arbeitsspeicher für einen solchen Bereich von der ProtocolBindAdapter-Funktion des Zwischentreibers bereitgestellt, die NdisIMInitializeDeviceInstanceEx mit einem Zeiger auf diesen Bereich aufruft, wodurch die MiniportInitialize-Funktion des Treibers aufgerufen wird. Ein zwischengeschalteter Treiber ist jedoch nicht erforderlich, um über einen solchen Kontextbereich zu verfügen.

Bei der Rückkehr von NdisIMGetDeviceContext richtet MiniportInitialize den vom Treiber definierten Zustand für die virtuelle NIC mit den Informationen ein, die der Zwischentreiberautor für noch höhere Protokolle verwenden möchte, die sich anschließend an die virtuelle NIC binden.

Noch höhere NDIS-Protokolle, die an dieselbe virtuelle NIC gebunden sind, können anschließend auf diesen Gerätekontextbereich zugreifen, indem sie NdisIMGetBindingContext über ihre ProtocolBindAdapter-Funktionen aufrufen.

Betriebssystemversionen: Windows CE .NET 4.0 und höher.

Anforderungen

Anforderung Wert
Header ndis.h
Bibliothek Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

Weitere Informationen