DOT11_SUPPORTED_ANTENNA_LIST構造 (windot11.h)
構文
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 メンバーのゼロ値は、空のリストを示します。
uTotalNumOfEntries
dot11SupportedAntenna 配列に含めることができるエントリの最大数。
dot11SupportedAntenna[1]
サポートされているアンテナの一覧。 このリストの各要素は、 DOT11_SUPPORTED_ANTENNA 構造体。
注釈
ミニポート ドライバーは、いずれかのクエリを実行すると、DOT11_SUPPORTED_ANTENNA_LIST構造体を返します OID_DOT11_SUPPORTED_RX_ANTENNA または OID_DOT11_SUPPORTED_TX_ANTENNA。
これらの OID に対してクエリを実行する場合、ミニポート ドライバーは、MiniportOidRequest 関数の 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構造体全体の長さ (バイト単位) に設定します。
- MiniportOidRequest 関数から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 メンバーにコピーする必要があります。
- MiniportOidRequest 関数からNDIS_STATUS_SUCCESSを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| Header | windot11.h (Ndis.h を含む) |