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)。 これは、NDIS API 呼び出しのコンテキストとして使用される MiniportHandle に関連付けられています。

[in, out] pMiniportDataHandlers

UE は NDIS ヘッダー フィールドを初期化するため、LE は、従来の NDIS バージョン管理規則に従って初期化しても安全なリビジョンとサイズを決定できます。 LE は、戻る前に LE が実際に実装およびサポートするリビジョンとサイズでヘッダーを更新する役割を担います。

[out] pMiniportWdiFrameMetadataExtraSpace

LE は、このパラメーターが指す値を、LE で使用する WDI_FRAME_METADATA の後に WDI が予約する必要がある領域の量に設定します。

戻り値

メモ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