大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
DOT11_SUPPORTED_ANTENNA_LIST構造体は、受信または送信操作に使用できるアンテナの一覧を指定します。
構文
typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;
メンバーズ
uNumOfEntries
dot11SupportedAntenna 配列内のエントリの数。 uNumOfEntries メンバーの 0 個の値は、空のリストを示します。
uTotalNumOfEntries
dot11SupportedAntenna 配列に含めることができるエントリの最大数。
dot11SupportedAntenna[1]
サポートされているアンテナの一覧。 このリスト内の各要素は、次のように書式設定されます。 DOT11_SUPPORTED_ANTENNA 構造体。
備考
ミニポート ドライバーは、いずれかの方法でクエリを実行すると、DOT11_SUPPORTED_ANTENNA_LIST構造体を返します。 OID_DOT11_SUPPORTED_RX_ANTENNA または OID_DOT11_SUPPORTED_TX_ANTENNA.
これらの OID を照会する場合、ミニポート ドライバーは、ミニポートOidRequest 関数の OidRequest パラメーターの InformationBuffer メンバーが、dot11SupportedAntenna 配列内のすべてのエントリを含む、DOT11_SUPPORTED_ANTENNA_LIST構造体全体を返すのに十分な大きさであることを確認する必要があります。 次の一覧に示すように、OidRequest パラメーターの InformationBufferLength メンバーの値によって、ミニポート ドライバーが実行する必要がある処理が決まります。
-
InformationBufferLength メンバーの値が、DOT11_SUPPORTED_ANTENNA_LIST構造体全体の長さ (バイト単位) 未満の場合、ミニポート ドライバーは次の操作を行う必要があります。
- uNumOfEntries メンバーを 0 に設定します。
-
uTotalNumOfEntries メンバーを、dot11SupportedAntenna 配列内のエントリの数に設定します。
OidRequest パラメーターの場合は、BytesWritten メンバーを 0 に設定し、BytesNeeded メンバーをDOT11_PHY_ID_LIST構造体全体の長さ (バイト単位) に設定します。
- ミニポートOidRequest 関数からNDIS_STATUS_BUFFER_OVERFLOWを返して、クエリ要求を失敗します。
-
InformationBufferLength メンバーの値が、DOT11_SUPPORTED_ANTENNA_LIST構造体全体の長さ (バイト単位) 以上の場合、ミニポート ドライバーは、正常なクエリ要求を完了するために次の操作を行う必要があります。
- DOT11_SUPPORTED_ANTENNA_LIST構造体の場合は、uNumOfEntries と uTotalNumOfEntries メンバーを、dot11SupportedAntenna 配列内のエントリの合計数に設定します。
- OidRequest パラメーターの場合は、BytesNeeded メンバーを 0 に設定し、BytesWritten メンバーをDOT11_SUPPORTED_ANTENNA_LIST構造体全体の長さ (バイト単位) に設定します。 ミニポート ドライバーは、DOT11_SUPPORTED_ANTENNA_LIST構造体全体を InformationBuffer メンバーにコピーする必要もあります。
- ミニポートOidRequest 関数からNDIS_STATUS_SUCCESSを返します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |