NdisMRegisterWdiMiniportDriver 函数 (dot11wdi.h)
重要
本主题是 Windows 10 中发布的 WDI 驱动程序模型的一部分。 WDI 驱动程序模型处于维护模式，仅接收高优先级修补程序。 WiFiCx 是 Windows 11 中发布的 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。
微型端口驱动程序调用 NdisMRegisterWdiMiniportDriver 函数，将 MiniportWdiXxx 入口点注册到 NDIS 作为初始化的第一步。
语法
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 微型端口驱动程序的 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 可以返回以下任何返回值。
| 返回代码 | 说明 |
|---|---|
|
NdisMRegisterWdiMiniportDriver 已成功注册 WDI 微型端口驱动程序。 |
|
对于 MiniportDriverCharacteristics 结构中的 MajorNdisVersion 成员指定的 NDIS 版本，CharacteristicsLength 参数不正确。 |
|
在特征结构中指定的 MajorNdisVersion 或 MinorNdisVersion 无效。 |
|
资源（可能是内存）的不足导致 NDIS 无法注册调用方。 |
|
这是默认错误状态，在上述任何错误都未导致注册失败时返回。 |
|
在发生故障时，适当的NDIS_STATUS代码。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10 |
| 最低受支持的服务器 | Windows Server 2016 |
| 目标平台 | Windows |
| 标头 | dot11wdi.h |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |