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 可以返回以下任何返回值。

返回代码 说明
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
Library Ndis.lib
IRQL PASSIVE_LEVEL

另请参阅

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS