共用方式為

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 迷你埠處理程式。

Note 您必須使用 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 在 WDI_FRAME_METADATA 之後保留的空間量，以供 LE 使用。

傳回值

注意 非NDIS_STATUS_SUCCESS 傳回值表示泛型失敗。
 
傳回碼 描述
NDIS_STATUS_SUCCESS
 表示迷你埠驅動程式已成功交換 Datapath 元件句柄。

要求

要求 價值
最低支援的用戶端 Windows 10
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
標頭 dot11wdi.h

另請參閱

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

TAL_TXRX_HANDLE

WDI 一般數據路徑介面

WDI_FRAME_METADATA