NdisMInitializeWrapper-Makro (ndis.h)

Artikel
02/27/2024

Hinweis NDIS 5. x wurde veraltet und wird von NDIS 6 abgelöst. x. Informationen zur Entwicklung neuer NDIS-Treiber finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x-Treiber auf NDIS 6. x, siehe Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisMInitializeWrapper benachrichtigt NDIS, dass ein neuer Miniporttreiber initialisiert wird.

Syntax

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Parameter

[out] _a

Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der NDIS ein Handle zurückgibt, das sich selbst darstellt. Wenn der Aufruf von NdisMInitializeWrapper fehlschlägt, legt NDIS die Variable bei NdisWrapperHandle auf NULL fest.

[in] _b

Gibt einen Zeiger eines systemspezifischen Typs an.

Bei Treibern unter Windows 2000 und höher ist dies ein Zeiger auf eine undurchsichtige Treiberobjekteingabe auf die DriverEntry-Funktion des Miniporttreibers.

[in] _c

Gibt einen Zeiger eines systemspezifischen Typs an.

Bei Treibern unter Windows 2000 und höher ist dies ein Zeiger auf eine undurchsichtige Registrierungspfadeingabe zur DriverEntry-Funktion des Miniporttreibers.

[in] _d

Gibt einen Zeiger eines systemspezifischen Typs an.

Bei Treibern unter Windows 2000 und höher sollte dieser Zeiger auf NULL festgelegt werden, wenn der Miniporttreiber NdisMInitializeWrapper aufruft.

Rückgabewert

Keine

Bemerkungen

Ein NIC-Treiber oder Zwischentreiber muss NdisMInitializeWrapper aufrufen, bevor eine andere NdisXxx-Funktion aufgerufen wird. Normalerweise ist dieser Aufruf die erste Aktion der DriverEntry-Funktion eines NIC-Treibers, die NdisMRegisterMiniport oder NdisIMRegisterLayeredMiniport mit dem zurückgegebenen NdisWrapperHandle als Nächstes aufruft. NDIS-Zwischentreiber müssen auch NdisMInitializeWrapper über die DriverEntry-Funktion aufrufen und dann NdisMRegisterMiniport oder NdisIMRegisterLayeredMiniport mit dem zurückgegebenen NdisWrapperHandle aufrufen.

Die nachfolgenden Aufrufe von NdisXxx-Initialisierungs - und Konfigurationsfunktionen eines solchen Treibers müssen NdisWrapperHandle als Parameter übergeben. Folglich handelt es sich um einen Eingabeparameter für die MiniportInitialize-Funktion .

Wenn der Aufruf von NdisMInitializeWrapper fehlschlägt, legt NDIS die Variable bei NdisWrapperHandle auf NULL fest. Der Treiber sollte immer den Wert dieser Variablen überprüfen, nachdem NdisMInitializeWrapper zurückgegeben wurde. Wenn der Wert NULL ist, sollte der Treiber beim Aufruf der DriverEntry-Funktion fehlschlagen.