OID_WDI_TASK_P2P_SEND_REQUEST_ACTION_FRAME (dot11wificxintf.h)
重要
このトピックは、WiFiCx ドライバー モデルの一部です。 WiFiCx は、Windows 11 でリリースされた Wi-Fi ドライバー モデルです。 最新機能を利用するには、WiFiCx を使用することをお勧めします。 以前の Wi-Fi ドライバー モデル WDI はメンテナンス モードであり、優先度の高い修正プログラムのみを受け取ります。
Wi-Fi Direct パブリック アクション フレーム要求を送信するための OID_WDI_TASK_P2P_SEND_REQUEST_ACTION_FRAME がデバイスに発行されます。
Object | Abort 可能 | 既定の優先度 (ホスト ドライバー ポリシー) | 通常の実行時間 (秒) |
---|---|---|---|
ポート | はい。 中止後、ポートはクリーン状態である必要があります。 | 3 | 5 |
このコマンドはOID_WDI_TASK_P2P_SEND_RESPONSE_ACTION_FRAMEとは異なり、時間の影響を大幅に受けやすい操作です。
デバイスは、要求フレームの受信確認を受信すると、100 ミリ秒の同じチャネルに常駐し、ホストに受信するすべての Wi-Fi Direct Public Action フレームを示します。
デバイスはタイムアウトになるまで、リモート デバイスのリッスン チャネル上のリモート デバイスに Wi-Fi Direct Public Action フレームの送信を再試行します。
タスクは、ローカル デバイスが送信されたアクション フレームの受信確認をリモート デバイスから受信したとき、タイムアウトになったとき、またはホストが操作を abort したときに完了します。 デバイスは、同じチャネルの滞留時間の有効期限切が過ぎた後でタスクの完了を示す場合があります。
ホストは、この操作を中止し、Wi-Fi Direct アクション フレーム交換を続行/再試行することを決定する場合があるため、デバイスでこの操作をすばやく中止できることが重要です。
検証
WDI バージョン 1.1.8 以降をサポートするミニポート ドライバーの場合、送信 P2P アクション フレームでの P2P IE の追加検証が追加されました。 この検証では、P2P IE のConfiguration Timeout属性が、OID_WDI_TASK_P2P_SEND_REQUEST_ACTION_FRAME と OID_WDI_TASK_P2P_SEND_RESPONSE_ACTION_FRAME で LE に提供される形式の単位が、IE 形式である数十ミリ秒単位に変換されないという一般的な問題に対処します。
P2P IE のConfiguration Timeout属性が送信アクション フレームで正しくエンコードされていない場合、WDI バージョン 1.1.8 以降をサポートするドライバーの Wi-Fi Direct および Wi-Fi Direct Services HLK テストは失敗します。 WDI バージョン 1.1.7 以前の場合、テストはテスト出力に警告を出力します。
WDI インターフェイス自体は変更されず、バージョン 1.1.7 以前と同様にミリ秒単位を使用し続けます。
タスク パラメーター
TLV | 複数の TLV インスタンスを許可 | 省略可能 | 説明 |
---|---|---|---|
WDI_TLV_P2P_SEND_ACTION_REQUEST_FRAME_PARAMETERS | アクション フレームの種類、ターゲット ピア アダプターのデバイス アドレス、ダイアログ トークンなどのパラメーター。 | ||
WDI_TLV_P2P_GO_NEGOTIATION_REQUEST_INFO | x | GO ネゴシエーション要求パラメータ。 ポートは、wfdRequestFrameType が GO ネゴシエーション要求である場合にのみ、この構造体を調べます。 | |
WDI_TLV_P2P_INVITATION_REQUEST_INFO | x | 招待要求パラメータ。 ポートは、wfdRequestFrameType が招待要求である場合にのみ、この構造体を調べます。 | |
WDI_TLV_P2P_PROVISION_DISCOVERY_REQUEST_INFO | x | Discovery 要求パラメーターをプロビジョニングします。 このポートは、wfdRequestFrameType が Provision Discovery 要求の場合にのみ、この構造体を調べる必要があります。 | |
WDI_TLV_BSS_ENTRY | ポートから Wi-Fi Direct Discovery タスクによって返されるデバイス検出エントリ。 これは、検出を必要とせずにリモート Wi-Fi Direct デバイスに Wi-Fi Direct Action フレーム要求を送信するために、ポートが探索データベースを記憶する必要がないように提供されます。 | ||
WDI_TLV_VENDOR_SPECIFIC_IE | x | ポートによって送信されるフレームに含める必要がある 1 つ以上の IE。 |
タスクの完了指示
NDIS_STATUS_WDI_INDICATION_P2P_SEND_REQUEST_ACTION_FRAME_COMPLETE
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 11 |
サポートされている最小のサーバー | Windows Server 2022 |
ヘッダー | dot11wificxintf.h |