NdisMInitializeWrapper 宏 (ndis.h)

發行項
02/26/2024

注意 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，然後使用傳回的 NdisWrapperHandle 呼叫 NdisMRegisterMiniport 或 NdisIMRegisterLayeredMiniport。

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

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