dot11wdi.h 标头

项目
03/13/2025

此标头由网络使用。有关详细信息，请参阅：

网络

dot11wdi.h 包含以下编程接口：

功能


NdisMDeregisterWdiMiniportDriver 微型端口驱动程序调用 NdisMDeregisterWdiMiniportDriver 函数，以释放它以前调用 NdisMRegisterWdiMiniportDriver 函数分配的资源。
NdisMRegisterWdiMiniportDriver 微型端口驱动程序调用 NdisMRegisterWdiMiniportDriver 函数，将 MiniportWdiXxx 入口点注册到 NDIS 作为初始化的第一步。

回调函数


MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE MiniportWdiAdapterHangDiagnose 处理程序函数用于收集硬件控制寄存器状态和可选完整固件状态。
MINIPORT_WDI_ALLOCATE_ADAPTER MiniportWdiAllocateAdapter 处理程序函数分配 WDI 微型端口适配器。
MINIPORT_WDI_CANCEL_IDLE_NOTIFICATION NDIS 调用 MiniportWdiCancelIdleNotification 处理程序函数，以通知 WDI 微型端口驱动程序 NDIS 检测到挂起的网络适配器上的活动。
MINIPORT_WDI_CLOSE_ADAPTER MiniportWdiCloseAdapter 处理程序函数由Microsoft组件用来启动 IHV 驱动程序上的 Close Task作。
MINIPORT_WDI_FREE_ADAPTER MiniportWdiFreeAdapter 处理程序函数请求 IHV 驱动程序删除其软件状态。
MINIPORT_WDI_IDLE_NOTIFICATION NDIS 调用 MiniportWdiIdleNotification 处理程序函数，以在空闲网络适配器上启动 NDIS 选择性挂起作。通过此作，网络适配器挂起并转换为低功率状态。
MINIPORT_WDI_OPEN_ADAPTER MiniportWdiOpenAdapter 处理程序函数由Microsoft组件用来启动 IHV 驱动程序上的 Open Task作。
MINIPORT_WDI_POST_ADAPTER_PAUSE MiniportWdiPostAdapterPause 处理程序函数在完成数据路径清理后由 Microsoft 组件调用，作为 NDIS MiniportPause 要求的一部分。
MINIPORT_WDI_POST_ADAPTER_RESTART MiniportWdiPostAdapterRestart 处理程序函数在Microsoft组件完成重启数据路径作为 NDIS MiniportRestart 要求的一部分后调用。
MINIPORT_WDI_RX_FLUSH MiniportWdiRxFlush 处理程序函数在 MiniportWdiRxStop作完成后发出。收到刷新请求后，目标/RxEngine 必须先放弃端口/适配器上所有未使用的帧，然后才能指示 RxFlushConfirm。
MINIPORT_WDI_RX_GET_MPDUS MiniportWdiRxGetMpdus 处理程序函数返回NET_BUFFER_LIST链。每个NET_BUFFER_LIST表示一个 MPDU。
MINIPORT_WDI_RX_PPDU_RSSI MiniportWdiRxPpduRssi 处理程序函数返回 PPDU 的 RSSI （以 dB 为单位）的绝对值。 RxMgr 可以使用从 MiniportWdiRxGetMpdus 获取PNET_BUFFER_LIST为每个数据指示请求 RSSI 一次。
MINIPORT_WDI_RX_RESTART MiniportWdiRxRestart 处理程序函数配置 RxEngine 以重启指示数据流量。这是在 MiniportWdiRxStop 之后颁发的。
MINIPORT_WDI_RX_RESUME MiniportWdiRxResume 处理程序函数在向数据指示返回暂停状态后由 RxMgr 发出。
MINIPORT_WDI_RX_RETURN_FRAMES MiniportWdiRxReturnFrames 处理程序函数将NET_BUFFER_LIST结构（和相关数据缓冲区）返回到 TAL。
MINIPORT_WDI_RX_STOP MiniportWdiRxStop 处理程序函数在给定端口上停止 RX，并接受通配符端口 ID 以在适配器上停止 RX。
MINIPORT_WDI_RX_THROTTLE MiniportWdiRxThrottle 处理程序函数告知 TAL/target，使机制能够降低 RX MSDU 的速率。
MINIPORT_WDI_START_ADAPTER_OPERATION IHV 驱动程序可以使用 MiniportWdiStartAdapterOperation 处理程序函数来执行任何其他 MiniportInitializeEx 任务。
MINIPORT_WDI_STOP_ADAPTER_OPERATION IHV 驱动程序可以使用 MiniportWdiStopAdapterOperation 处理程序函数撤消 MiniportWdiStartAdapterOperation 中执行的作。
MINIPORT_WDI_TAL_TXRX_ADD_PORT MiniportWdiTalTxRxAddPort 处理程序函数通知创建新虚拟端口的数据路径组件。
MINIPORT_WDI_TAL_TXRX_DEINITIALIZE MiniportWdiTalTxRxDeinitialize 处理程序函数在微型端口停止的上下文中调用。功能组件 RXEngine 和 TxEngine 已停止，所有挂起的数据帧已完成/返回。
MINIPORT_WDI_TAL_TXRX_DELETE_PORT MiniportWdiTalTxRxDeletePort 处理程序函数通知删除虚拟端口的数据路径组件。
MINIPORT_WDI_TAL_TXRX_INITIALIZE MiniportWdiTalTxRxInitialize 处理程序函数初始化 TAL 中的数据结构，并在 UE 和 TAL 之间交换数据路径组件句柄。
MINIPORT_WDI_TAL_TXRX_PEER_CONFIG MiniportWdiTalTxRxPeerConfig 处理程序函数指定端口 ID、对等 ID 和对等功能（例如 QoS 功能）。在对等关联后调用它，这涉及到在 TAL 中创建对等对象。
MINIPORT_WDI_TAL_TXRX_PEER_DELETE_CONFIRM MiniportWdiTalTxRxPeerDeleteConfirm 处理程序函数在完成 PeerDeleteIndication 调用后调用，该调用未返回成功。
MINIPORT_WDI_TAL_TXRX_RESET_PORT 在向目标发出 dot11 重置任务之前调用 MiniportWdiTalTxRxResetPort 处理程序函数。
MINIPORT_WDI_TAL_TXRX_SET_PORT_OPMODE MiniportWdiTalTxRxSetPortOpMode 处理程序函数指定用于端口的 opmode，以便 TxEngine 和 RxEngine 启用相应的功能。
MINIPORT_WDI_TAL_TXRX_START MiniportWdiTalTxRxStart 处理程序函数向 TAL 提供 TXRX 配置参数。
MINIPORT_WDI_TAL_TXRX_STOP MiniportWdiTalTxRxStop 处理程序函数停止 TAL 与目标之间的 TXRX 通信。
MINIPORT_WDI_TX_ABORT MiniportWdiTxAbort 处理程序函数中止给定端口或对等的未完成 TX 帧，包括启动 TAL/target 拥有的帧的完成。
MINIPORT_WDI_TX_DATA_SEND MiniportWdiTxDataSend 处理程序函数指定要从中传输的 RA-TID 或端口队列。它在作系统、恢复指示或工作项的 TX 线程上下文中发出。
MINIPORT_WDI_TX_PEER_BACKLOG 暂停的对等方在积压工作状态发生更改时发出 MiniportWdiTxPeerBacklog 处理程序函数。
MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT TxSuspectFrameListAbort 回调函数由客户端驱动程序实现，以通知 TxEngine TxMgr 已确定疑似挂起或挂起完成的帧，时间很长。
MINIPORT_WDI_TX_TAL_QUEUE_IN_ORDER MiniportWdiTxTalQueueInOrder 处理程序函数通知 TAL 目标：一个或多个暂停的 RA/TID 队列（带有WDI_TX_PAUSE_REASON_PS）已准备好传输。
MINIPORT_WDI_TX_TAL_SEND MiniportWdiTxTalSend 处理程序函数指定要从中传输的 RA-TID 或端口队列。
MINIPORT_WDI_TX_TAL_SEND_COMPLETE MiniportWdiTxTalSendComplete 处理程序函数返回由 TAL 注入回 TxEngine 的一个或多个 TX 帧的所有权。
MINIPORT_WDI_TX_TARGET_DESC_DEINIT MINIPORT_WDI_TX_TARGET_DESC_DEINIT回调函数通知 TxEngine，与 NBL 链中NET_BUFFER_LIST（NBL）关联的目标 TX 描述符不再需要并且可以释放。
MINIPORT_WDI_TX_TARGET_DESC_INIT MINIPORT_WDI_TX_TARGET_DESC_INIT回调函数将不透明的目标 TX 描述符与NET_BUFFER_LIST（MiniportReserved[1] 字段）相关联，并且（如果适用）在NET_BUFFER_LIST（MiniportReserved[0]）的WDI_FRAME_METADATA缓冲区中填充 TX 成本字段（以额度单位为单位）。
NDIS_WDI_ALLOCATE_WDI_FRAME_METADATA NdisWdiAllocateWiFiFrameMetaData 回调函数分配帧元数据缓冲区。
NDIS_WDI_CLOSE_ADAPTER_COMPLETE 成功启动 MiniportWdiCloseAdapter 的 Close Task作时，IHV 将调用 NdisWdiCloseAdapterComplete 回调函数。
NDIS_WDI_FREE_WDI_FRAME_METADATA NdisWdiFreeWiFiFrameMetaData 回调函数释放帧元数据缓冲区。
NDIS_WDI_IDLE_NOTIFICATION_COMPLETE 微型端口驱动程序调用 NdisWdiIdleNotificationComplete 回调函数，以完成 NDIS 选择性挂起作的挂起空闲通知。 NDIS 在调用驱动程序的 MiniportWdiIdleNotification 处理程序函数时开始该作。
NDIS_WDI_IDLE_NOTIFICATION_CONFIRM 微型端口驱动程序调用 NdisWdiIdleNotificationConfirm 回调函数，以通知 NDIS 空闲网络适配器可以安全地挂起并转换为低功率状态。
NDIS_WDI_OPEN_ADAPTER_COMPLETE 成功启动 MiniportWdiOpenAdapter 的 Open Task作时，IHV 将调用 NdisWdiOpenAdapterComplete 回调函数。
NDIS_WDI_PEER_CREATE_IND NdisWdiPeerCreateIndication 回调函数指定要与对等 MAC 地址关联的对等 ID。
NDIS_WDI_PEER_DELETE_IND NdisWdiPeerDeleteIndication 回调函数启动对等 ID 与对等 MAC 地址之间的关联删除。
NDIS_WDI_RX_FLUSH_CONFIRM NdisWdiRxFlushConfirm 回调函数指示 MiniportWdiRxFlush 请求的完成。在发出 NdisWdiRxFlushConfirm 之前，RxEngine 必须完成与刷新请求匹配的所有 RX 数据帧的放弃。
NDIS_WDI_RX_INORDER_DATA_IND NdisWdiRxInorderDataIndication 回调函数通知 RxMgr，指定 RX 帧列表的顺序正确。
NDIS_WDI_RX_STOP_CONFIRM NdisWdiRxStopConfirm 回调函数指示 MiniportWdiRxStop 请求的完成。
NDIS_WDI_TX_ABORT_CONFIRM NdisWdiTxAbortConfirm 回调函数指示从 WDI 异步确认 MiniportWdiTxAbort。
NDIS_WDI_TX_DEQUEUE_IND NdisWdiTxDequeueIndication 回调函数在 IHV 微型端口的 MiniportWdiTxDataSend 或 MiniportWdiTxTalSend 的上下文中调用，以便将帧从 WDI 取消到 IHV 微型端口。
NDIS_WDI_TX_INJECT_FRAME_IND NdisWdiTxInjectFrameIndication 回调函数允许 LE 通过常规数据路径注入帧（例如身份验证/关联请求/响应，Wi-Fi 直接作帧）。
NDIS_WDI_TX_QUERY_RA_TID_STATE TxEngine 使用 NdisWdiTxQueryRATIDState 回调函数查询 RA/TID 或端口队列的状态。
NDIS_WDI_TX_QUERY_SUSPECT_FRAME_COMPLETE_STATUS TxQuerySuspectFrameStatus 回调函数由 IHV 微型端口实现，用于查询可疑帧的状态。
NDIS_WDI_TX_RELEASE_FRAMES_IND 当传输暂停时，NdisWdiTxReleaseFrameIndication 回调函数最多释放到指定数目或排队到给定对等 TID 组合的帧的总成本。
NDIS_WDI_TX_SEND_COMPLETE_IND NdisWdiTxSendCompleteIndication 回调函数指定与目标发送帧关联的帧 ID 数组。
NDIS_WDI_TX_SEND_PAUSE_IND NdisWdiTxSendPauseIndication 回调函数将给定端口上的传输暂停到给定对等或对等 TID 组合。
NDIS_WDI_TX_SEND_RESTART_IND NdisWdiTxSendRestartIndication 回调函数将给定端口上的传输恢复到给定对等或对等 TID 组合。
NDIS_WDI_TX_TRANSFER_COMPLETE_IND NdisWdiTxTransferCompleteIndication 回调函数指定已传输到目标的帧缓冲区列表。具有不同 TX 状态值的帧以单独的指示完成。

结构


NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS结构定义 WDI 微型端口驱动程序必须实现的处理程序集。
NDIS_MINIPORT_WDI_DATA_HANDLERS NDIS_MINIPORT_WDI_DATA_HANDLERS结构指定 IHV 微型端口数据路径处理程序的入口点。
NDIS_WDI_DATA_API NDIS_WDI_DATA_API结构指定 WDI 数据指示的入口点。
NDIS_WDI_INIT_PARAMETERS NDIS_WDI_INIT_PARAMETERS结构指定作系统提供的 WDI 函数，并由 IHV WDI 驱动程序调用。
TAL_TXRX_PARAMETERS TAL_TXRX_PARAMETERS结构定义 TAL TXRX 参数。
WDI_FRAME_METADATA WDI_FRAME_METADATA结构定义帧元数据。
WDI_MAC_ADDRESS WDI_MAC_ADDRESS结构定义 IEEE 媒体访问控制（MAC）地址。
WDI_MESSAGE_HEADER WDI_MESSAGE_HEADER结构定义 WDI 消息标头。所有 WDI 命令消息都必须以此标头开头。
WDI_P2P_SERVICE_NAME_HASH WDI_P2P_SERVICE_NAME_HASH结构定义 WFDS 服务名称的哈希。
WDI_RX_METADATA WDI_RX_METADATA结构定义 RX 元数据。
WDI_TX_COMPLETE_DATA WDI_TX_COMPLETE_DATA结构定义 TX 完成数据。
WDI_TX_METADATA WDI_TX_METADATA结构定义 TX 元数据。
WDI_TXRX_CAPABILITIES WDI_TXRX_CAPABILITIES结构定义目标功能。
WDI_TXRX_MPDU_PN WDI_TXRX_MPDU_PN联合定义传递给 TXRX 组件的参数。
WDI_TXRX_PARAMETERS WDI_TXRX_PARAMETERS结构定义传递给 TXRX 组件的参数。
WDI_TXRX_PEER_CFG WDI_TXRX_PEER_CFG结构定义对等配置。
WDI_TXRX_TARGET_CONFIGURATION WDI_TXRX_TARGET_CONFIGURATION结构定义目标配置。

枚举


eDiagnoseLevel eDiagnoseLevel 枚举定义适配器挂起诊断的诊断级别。
WDI_EXEMPTION_ACTION_TYPE WDI_EXEMPTION_ACTION_TYPE枚举定义豁免类型。
WDI_FRAME_PAYLOAD_TYPE WDI_FRAME_PAYLOAD_TYPE枚举定义帧有效负载类型。
WDI_INTERCONNECT_TYPE WDI_INTERCONNECT_TYPE枚举定义互连类型。
WDI_OPERATION_MODE WDI_OPERATION_MODE枚举定义作模式。
WDI_RX_INDICATION_LEVEL WDI_RX_INDICATION_LEVEL枚举定义 RX 指示级别。
WDI_RX_THROTTLE_LEVEL WDI_RX_THROTTLE_LEVEL枚举定义 RX 限制级别。这些限制级别的解释和实现机制由独立硬件供应商（IHV）定义。
WDI_TX_FRAME_STATUS WDI_TX_FRAME_STATUS枚举定义 TX 帧状态值。
WDI_TX_PAUSE_REASON WDI_TX_PAUSE_REASON枚举定义 TX 暂停的原因。
WDI_TXRX_PEER_QOS_CAPS WDI_TXRX_PEER_QOS_CAPS枚举定义服务质量（QoS）功能。

通过

dot11wdi.h 标头

功能

回调函数

结构

枚举

反馈

其他资源