NdisMInitializeWrapper 巨集（ndis.h）

發行項
02/07/2025

附註 NDIS 5。 x 已被取代，且已被 NDIS 6 取代。 x。如需新的 NDIS 驅動程式開發，請參閱從 Windows Vista 開始網路驅動程式。如需移植 NDIS 5 的相關信息。 x 驅動程式至 NDIS 6。 x，請參閱將 NDIS 5.x 驅動程式移植到 NDIS 6.0。

NdisMInitializeWrapper 會通知 NDIS 新的迷你埠驅動程式正在初始化。

語法

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

參數

[out] _a

呼叫端提供的變數指標，其中 NDIS 會傳回代表本身的句柄。如果呼叫 NdisMInitializeWrapper 失敗，NDIS 會將 NdisWrapperHandle 的變數設定為 NULL。

[in] _b

指定系統特定類型的指標。

對於 Windows 2000 和更新版本的驅動程式，這是迷你埠驅動程式 DriverEntry 函式的不透明驅動程式對象輸入指標。

[in] _c

指定系統特定類型的指標。

針對 Windows 2000 和更新版本的驅動程式，這是迷你埠驅動程式 DriverEntry 函式的不透明登錄路徑輸入指標。

[in] _d

指定系統特定類型的指標。

針對 Windows 2000 和更新版本的驅動程式，當迷你埠驅動程式呼叫 NdisMInitializeWrapper時，此指標應設定為 NULL。

傳回值

沒有

言論

NIC 驅動程式或中繼驅動程序必須先呼叫 NdisMInitializeWrapper，才能呼叫任何其他 NdisXxx 函式。通常，此呼叫是任何 NIC 驅動程式 DriverEntry 函式的初始動作，其會呼叫 NdisMRegisterMiniport 或 NdisIMRegisterLayeredMiniport，並接著傳回 NdisWrapperHandle。 NDIS 中繼驅動程式也必須從 DriverEntry 函式呼叫 NdisMInitializeWrapper，然後呼叫 NdisMRegisterMiniport 或 NdisIMRegisterLayeredMiniport，並傳回 NdisWrapperHandle。

這類驅動程式後續對 NdisXxx 的呼叫 初始化和設定函式必須傳遞 NdisWrapperHandle 做為參數。因此，它是 MiniportInitialize 函式的輸入參數。

如果呼叫 NdisMInitializeWrapper 失敗，NDIS 會將變數設定為 NdisWrapperHandleNULL。 NdisMInitializeWrapp er 傳回之後，驅動程式應該一律檢查此變數的值。如果值為 NULL ，驅動程式應該會失敗呼叫 DriverEntry 函式。