NDIS_WDI_PEER_CREATE_IND コールバック関数 (dot11wdi.h)

[アーティクル]
02/23/2024

重要

このトピックは、Windows 10でリリースされた WDI ドライバーモデルの一部です。 WDI ドライバーモデルはメンテナンスモードであり、優先度の高い修正のみを受け取ります。 WiFiCx は、Windows 11でリリースされた Wi-Fi ドライバーモデルです。最新の機能を利用するには、WiFiCx を使用することをお勧めします。

NdisWdiPeerCreateIndication コールバック関数は、ピア MAC アドレスに関連付けるピア ID を指定します。

これは、 NDIS_WDI_DATA_API内のコールバックです。

構文

NDIS_WDI_PEER_CREATE_IND NdisWdiPeerCreateInd;

void NdisWdiPeerCreateInd(
  [in] NDIS_HANDLE NdisMiniportDataPathHandle,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_MAC_ADDRESS PeerAddr
)
{...}

パラメーター

[in] NdisMiniportDataPathHandle

NdisMiniportDataPathHandle は、ミニポートWdiTalTxRxInitialize の IHV ミニポートに渡されます。

[in] PortId

ポート ID。

[in] PeerId

ピア ID。これは、後続のコマンドと指示でピアを識別するために使用されます。

[in] PeerAddr

ピア MAC アドレス。

戻り値

なし

解説

これは、ピアとフレームを交換する前に受信して処理する必要があります。

AP またはダイレクト GO モードで動作 Wi-Fi ポートには、複数のピア (クライアント) が同時に含まれる場合があります。ポートが AP または Direct GO モードで動作 Wi-Fi 場合、IHV ミニポートは、(ブロードキャスト MAC アドレスを渡すことによって) グループアドレス指定トラフィックの "ピア" を作成します。このポートのすべてのマルチキャストトラフィックとブロードキャストトラフィックは、このピアに関連付けられます。ポートキューモードでは、このモードでは Tx フレーム分類が行われないため、IHV ミニポートによるグループピアの作成は必要ありません。

任意のモードで動作するポートは、グループピアを作成できます。

IHV コンポーネントでの TDLS の実装を容易にするために、STA またはダイレクトクライアントモードで動作するポート Wi-Fi、複数のピアを同時に持つことができます。 TX フレームの宛先 MAC アドレスが非 AP/GO ピア ID に関連付けられている場合、TxMgr は、その AP/GO 以外のピアに関連付けられた TID キューを使用してフレームをキューに入れます (WDI が PeerTID キューモードで動作している場合)。

ピアキューモードでは、すべての TID がWDI_TX_PAUSE_REASON_PEER_CREATEで一時停止された状態でピアが作成されます。

要件

要件	値
サポートされている最小のクライアント	Windows 10
サポートされている最小のサーバー	Windows Server 2016
対象プラットフォーム	Windows
ヘッダー	dot11wdi.h