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