DOT11_AUTH_CIPHER_PAIR_LIST 結構 (windot11.h)
語法
typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
NDIS_OBJECT_HEADER Header;
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;
成員
Header
DOT11_AUTH_CIPHER_PAIR_LIST 結構的型別、修訂和大小。 這個成員會格式化為 NDIS_OBJECT_HEADER 結構。
迷你埠驅動程序必須將 Header 的成員設定為下列值:
類型
這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。
修訂版
這個成員必須設定為 DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1。
大小
這個成員必須設定為 sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)
。
如需這些成員的詳細資訊,請參閱 NDIS_OBJECT_HEADER。
uNumOfEntries
AuthCipherPairs 陣列中的項目數。
uTotalNumOfEntries
AuthCipherPairs 陣列可以包含的最大項目數。
AuthCipherPairs[1]
的清單 DOT11_AUTH_CIPHER_PAIR 結構。
備註
迷你埠驅動程式會在其中一個查詢時傳回DOT11_AUTH_CIPHER_PAIR_LIST結構 OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR 或 OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR。
查詢這些 OID 時,迷你埠驅動程式必須確認 MiniportOidRequest 函式 OidRequest 參數的 InformationBuffer 成員夠大,足以傳回整個DOT11_AUTH_CIPHER_PAIR_LIST結構,包括 AuthCipherPairs 陣列中的所有專案。 OidRequest 參數之 InformationBufferLength 成員的值會決定迷你埠驅動程式必須執行的動作,如下列清單所示:
-
如果 InformationBufferLength 成員的值小於整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度,以位元組為單位,迷你埠驅動程式必須執行下列動作:
- 針對 OidRequest 參數,將 BytesWritten 成員設定為零,並將 BytesNeeded 成員設定為整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度,以位元組為單位。
- 從 其MiniportOidRequest 函式傳回NDIS_STATUS_BUFFER_OVERFLOW,使查詢要求失敗。
-
如果 InformationBufferLength 成員的值大於或等於整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度,以位元組為單位,迷你埠驅動程式必須執行下列動作,才能完成成功的查詢要求:
- 針對DOT11_AUTH_CIPHER_PAIR_LIST結構,請將 uNumOfEntries 和 uTotalNumOfEntries 成員設定為 AuthCipherPairs 陣列中的項目總數。
- 針對 OidRequest 參數,請將 BytesNeeded 成員設定為零,並將 BytesWritten 成員設定為整個 DOT11_AUTH_CIPHER_PAIR_LIST 結構的長度,以位元組為單位。 迷你埠驅動程式也必須將整個DOT11_AUTH_CIPHER_PAIR_LIST結構複製到 InformationBuffer 成員。
- 從 其MiniportOidRequest 函式傳回NDIS_STATUS_SUCCESS。
如果在以可延伸AP模式運作的NIC上啟用WPS,迷你埠驅動程序必須使用 開放式系統驗證 或 有線對等隱私權 (WEP) 演算法,允許對等站與可延伸AP產生關聯,而不論已啟用的授權和加密演算法為何。 如需WPS和可延伸AP的詳細資訊,請參閱 OID_DOT11_WPS_ENABLED。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 | windot11.h (包含 Ndis.h) |