NdisMInitializeWrapper-Makro (ndis.h)

Artikel
02/07/2025

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.

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 Windows 2000 und höheren Treibern ist dies ein Zeiger auf eine undurchsichtige Treiberobjekteingabe auf die DriverEntry-Funktion des Miniporttreibers.

[in] _c

Gibt einen Zeiger eines systemspezifischen Typs an.

Bei Windows 2000 und höheren Treibern ist dies ein Zeiger auf eine undurchsichtige Registrierungspfadeingabe auf die DriverEntry-funktion des Miniporttreibers.

[in] _d

Gibt einen Zeiger eines systemspezifischen Typs an.

Für Windows 2000 und höhere Treiber sollte dieser Zeiger auf NULL- festgelegt werden, wenn der Miniporttreiber NdisMInitializeWrapper-aufruft.

Rückgabewert

Nichts

Bemerkungen

Ein NIC-Treiber oder Zwischentreiber muss NdisMInitializeWrapper- aufrufen, bevor er eine andere NdisXxx-Funktion aufruft. In der Regel ist dieser Aufruf die erste Aktion der DriverEntry-Funktion eines NIC-Treibers, die NdisMRegisterMiniport oder NdisIMRegisterLayeredMiniport mit dem zurückgegebenen NdisWrapperHandle nächsten aufruft. NDIS-Zwischentreiber müssen auch NdisMInitializeWrapper aus der DriverEntry--Funktion aufrufen und dann NdisMRegisterMiniport oder NdisIMRegisterLayeredMiniport mit dem zurückgegebenen NdisWrapperHandleaufrufen.

Die nachfolgenden Aufrufe eines solchen Treibers an NdisXxx Initialisierungs- und Konfigurationsfunktionen müssen die 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 den Wert dieser Variablen immer überprüfen, nachdem NdisMInitializeWrapper zurückgegeben wurde. Wenn der Wert NULL-ist, sollte der Treiber den Aufruf der DriverEntry--Funktion fehlschlagen.