MINIPORT_WDI_TAL_TXRX_INITIALIZE回调函数 (dot11wdi.h)

  • 项目

重要

本主题是 Windows 10 中发布的 WDI 驱动程序模型的一部分。 WDI 驱动程序模型处于维护模式，仅接收高优先级修补程序。 WiFiCx 是 Windows 11 中发布的 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。

MiniportWdiTalTxRxInitialize 处理程序函数初始化 TAL 中的数据结构，并在 UE 和 TAL 之间交换数据路径组件句柄。 这是在驱动程序初始化的上下文中发出的，是在查询固件设备功能之前发出的。

这是 NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS内的 WDI 微型端口处理程序。

注意 必须使用 MINIPORT_WDI_TAL_TXRX_INITIALIZE 类型声明函数。 有关详细信息，请参阅以下示例部分。
 

语法

MINIPORT_WDI_TAL_TXRX_INITIALIZE MiniportWdiTalTxrxInitialize;

NDIS_STATUS MiniportWdiTalTxrxInitialize(
  [in]      NDIS_HANDLE MiniportAdapterContext,
  [in]      NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]      PNDIS_WDI_DATA_API NdisWdiDataPathApi,
  [out]     PTAL_TXRX_HANDLE pMiniportTalTxRxContext,
  [in, out] PNDIS_MINIPORT_WDI_DATA_HANDLERS pMiniportDataHandlers,
  [out]     UINT32 *pMiniportWdiFrameMetadataExtraSpace
)
{...}

参数

[in] MiniportAdapterContext

IHV 微型端口上下文的句柄。

[in] NdisMiniportDataPathHandle

要用于数据路径指示的 IHV 微型端口的句柄。

[in] NdisWdiDataPathApi

指向 WDI 数据 API 函数表的指针。

[out] pMiniportTalTxRxContext

TAL 设备句柄是设备 (的控制路径句柄，例如 MiniportContext) 。 它与 MiniportHandle 相关联，后者用作 NDIS API 调用的上下文。

[in, out] pMiniportDataHandlers

UE 初始化 NDIS 标头字段，以便 LE 可以确定根据传统 NDIS 版本控制规则可以安全初始化的修订和大小。 LE 负责在返回之前使用 LE 实际实现和支持的修订和大小更新标头。

[out] pMiniportWdiFrameMetadataExtraSpace

LE 将此参数指向的值设置为 WDI 在 LE 要使用的WDI_FRAME_METADATA 后应保留的空间量。

返回值

注意 非NDIS_STATUS_SUCCESS 返回值表示一般故障。
 
返回代码 说明
NDIS_STATUS_SUCCESS
 指示微型端口驱动程序已成功交换数据路径组件句柄。

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 dot11wdi.h

另请参阅

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

WDI 常规数据路径接口

WDI_FRAME_METADATA