NdisMRegisterWdiMiniportDriver 函式 (dot11wdi.h)

  • 發行項

重要

本主題是 Windows 10 中發行的 WDI 驅動程式模型的一部分。 WDI 驅動程式模型處於維護模式，而且只會收到高優先順序修正。 WiFiCx 是 Windows 11 中發行的 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。

迷你埠驅動程式會呼叫 NdisMRegisterWdiMiniportDriver 函式，向 NDIS 註冊 MiniportWdiXxx 進入點作為初始化的第一個步驟。

語法

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

參數

[in] DriverObject

迷你埠驅動程式在其 DriverEntry 例程中於 Argument1 參數收到的不透明驅動程式物件的指標， (請參閱 NDIS Miniport Drivers 的 DriverEntry) 。

[in] RegistryPath

迷你埠驅動程式在其 DriverEntry 例程中於 Argument2 參數收到的不透明登錄路徑指標。

[in, optional] NdisDriverContext

驅動程式所配置內容區域的句柄，其中驅動程式會維護狀態和設定資訊。

[in] MiniportDriverCharacteristics

的指標 NDIS_MINIPORT_DRIVER_CHARACTERISTICS 呼叫端初始化的結構。

[in] MiniportWdiCharacteristics

呼叫端初始化 之NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS 結構的指標。

[out] NdisMiniportDriverHandle

呼叫端提供的句柄變數指標。 NDIS 會將句柄寫入可唯一識別此驅動程式的這個變數。 驅動程式必須儲存此句柄，以供後續 的 NdisXxx 函數調用使用。

傳回值

NdisMRegisterWdiMiniportDriver 可以傳回下列任何傳回值。

傳回碼 Description
NDIS_STATUS_SUCCESS
 NdisMRegisterWdiMiniportDriver 已成功註冊 WDI 迷你埠驅動程式。
NDIS_STATUS_BAD_CHARACTERISTICS
 在 MiniportDriverCharacteristics 結構中 MajorNdisVersion 成員指定的 NDIS 版本，CharacteristicsLength 參數不正確。
NDIS_STATUS_BAD_VERSION
 特性結構中指定的 MajorNdisVersion 或 MinorNdisVersion 無效。
NDIS_STATUS_RESOURCES
 資源不足，可能是記憶體不足，導致 NDIS 無法註冊呼叫端。
NDIS_STATUS_FAILURE
 這是預設的錯誤狀態，當上述任何錯誤都導致註冊失敗時傳回。
其他NDIS_STATUS代碼
 發生失敗時，適當的NDIS_STATUS程序代碼。

規格需求

需求 值
最低支援的用戶端 Windows 10
最低支援的伺服器 Windows Server 2016
目標平台 Windows
標頭 dot11wdi.h
程式庫 Ndis.lib
IRQL PASSIVE_LEVEL

另請參閱

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS