OID_WDI_TASK_START_AP (dot11wificxintf.h)

重要

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

OID_WDI_TASK_START_AP は、IHV コンポーネントが、指定されたポートで Wi-Fi Direct グループ所有者を起動するようにポートを構成するように要求します。

Object	中止可能	既定の優先度 (ホスト ドライバー ポリシー)	通常の実行時間 (秒)
ポート	はい。 中止の後には、dot11 リセットが必要です。	4	1

初期化中、ドライバーは WIFI_WIFIDIRECT_CAPABILITIES の 5 GHz 帯域の GO 機能を設定して、5 GHz 帯域でアクセス ポイントを起動できるかどうかを示します。

5 GHz 帯域サポートの GO が設定されている場合、アダプターは、アドバタイズされた動作チャネルで AP を起動する必要があり、それが失敗した場合は、AP バンド チャネル リスト パラメーターで指定されたリストを試す必要があります。 オペレーティング システムは、WDI_TLV_P2P_GROUP_OWNER_CAPABILITY に DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED フラグを設定することで、この AP がインターネット接続を提供するかどうかについてのヒントをドライバーに提供します。

WDI_TLV_START_AP_PARAMETERS の MustUseSpecifiedChannel が指定されている場合、指定された帯域/チャネルで AP を起動できない場合、AP は次のいずれかのエラーを返すことがあります。

• NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE:現在、指定されたチャネルで AP を起動できません。 後で、指定したチャネルで再試行します。

• NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: 現在、指定された帯域で AP を起動できません。 後で指定した帯域で再試行します。

• NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: 規制上の理由により、指定されたチャネルで AP を起動できません。

• NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: 規制上の理由により、指定された帯域で AP を起動できません。

タスク パラメーター

TLV	複数の TLV インスタンスを許可	省略可能	説明
WDI_TLV_SSID			AP が使用する SSID。
WDI_TLV_START_AP_PARAMETERS			このタスクの追加パラメーター。
WDI_TLV_AUTH_ALGO_LIST			接続で使用できる認証アルゴリズムのリスト。
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST			接続で使用できるマルチキャスト暗号アルゴリズムのリスト。
WDI_TLV_UNICAST_CIPHER_ALGO_LIST			接続で使用できるマルチキャスト暗号アルゴリズムのリスト。
WDI_TLV_P2P_CHANNEL_NUMBER		x	指定した場合、これは、グループ形成で決定される動作チャネルを定義します。 これは、動作モードが Wi-Fi Direct GO の場合にのみ指定できます。
WDI_TLV_AP_BAND_CHANNEL	x	x	アクセス ポイントを起動する帯域とチャネルのオプションのリスト。 MustUseSpecifiedChannels が 1 に設定されている場合、AP は、このリストからのみ起動できます。 設定されていない場合、このリストは、ファームウェアが選択できるチャネルの推奨であり、指定されたチャネルのいずれでも AP を起動できない場合は別のチャネルを選択することができます。

タスク完了表示

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

要件

要件	Value
サポートされている最小のクライアント	Windows 11
サポートされている最小のサーバー	Windows Server 2022
ヘッダー	dot11wificxintf.h