WDI_CONNECTION_QUALITY_HINT列挙 (wditypes.hpp)

重要

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

WDI_CONNECTION_QUALITY_HINT列挙は、Wi-Fi 接続品質ヒントを定義します。

構文

typedef enum _WDI_CONNECTION_QUALITY_HINT {
  WDI_CONNECTION_QUALITY_AUTO_POWER_SAVE,
  WDI_CONNECTION_QUALITY_LOW_LATENCY,
  WDI_CONNECTION_QUALITY_HIGH_THROUGHPUT,
  WDI_CONNECTION_QUALITY_NO_POWER_SAVE
} WDI_CONNECTION_QUALITY_HINT;

定数

WDI_CONNECTION_QUALITY_AUTO_POWER_SAVE このヒントは、ホストにこのポートの使用に関する特定の優先設定がないことを示します。 ポートでは、可能な限り省電力メカニズムを使用する必要があります。また、他のポートで帯域幅/無線時間のより大きな共有が必要な場合にも使用する必要があります。 複数のポートで同時に有効にすることができます。 これは、ポートの既定の接続品質設定です。
WDI_CONNECTION_QUALITY_LOW_LATENCY このヒントは、ホストが待機時間の短い操作にこのポートを使用することを望んでいることを示します。 アダプターは、定期的にこのポートにサービスを提供する必要があります。 WLAN スケジュールは、一方向の待機時間が 30 ミリ秒以下、パケット損失が <=0.5%、連続するパケットが 3 個以下になるようにする必要があります。 また、指定されたオフチャネル待機時間要件も考慮する必要があります。 これは、2 つのポートで同時に設定できます。 ポートが異なるチャネルにある場合、最大待機時間は 50 ミリ秒に緩和されます。 これは、Windows 認定プログラムの要件に基づいています。 このモードの場合、ポートは上記の待機時間の要件を満たす限り、(必要に応じて) 省電力を使用できます。 さらに、ポートがこのモードの場合、アダプターは不要なスキャンを回避する必要があります。 アダプターが Microsoft コンポーネントによってトリガーされないスキャンを実行する必要がある場合は、オフチャネル時間の要件を満たすようにスキャンを最適化する必要があります。 このため、スキャンを一度に 1 つのオフ チャネルに制限できます。 ポートがこのモードの場合、ローミング中に、アダプターは AP の選択を最適化する必要があります (たとえば、スキャンやローミングが頻繁に行われないように、異なるリンク品質しきい値を使用する)、関連付けプロセス (同期にキャッシュされた TSF を使用するなど)、およびセキュリティ交換 (PMKID の使用に関してより積極的であることなど)。
WDI_CONNECTION_QUALITY_HIGH_THROUGHPUT このヒントは、ホストがパケット損失に対して許容されない操作をポートで実行していることを示します。 アダプターは、この接続品質ヒントが設定解除されるまで、他のポートのリンク接続を失うことなく、指定されたポートの操作チャネルにできるだけ長く残す必要があります。 これは、L2 プロトコル (EAP/4 ウェイ ハンドシェイク交換など)、L3 プロトコル (DHCP など)、またはチャネルの高可用性が全体的なエクスペリエンスにとって重要なその他のシナリオによって設定される可能性があります。 これは、1 つのポートでのみ設定できます。
WDI_CONNECTION_QUALITY_NO_POWER_SAVE このヒントは、ホストがアダプターで省電力を実行することを望まないことを示します。 データ パスのパフォーマンスに関する特定の要件はありません。

要件

要件	値
サポートされている最小のクライアント	Windows 10
サポートされている最小のサーバー	Windows Server 2016
Header	wditypes.hpp