DOT11_PHY_ID_LIST 結構 (windot11.h)

語法

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

成員

Header

DOT11_PHY_ID_LIST 結構的型別、修訂和大小。 這個成員會格式化為 NDIS_OBJECT_HEADER 結構。

迷你埠驅動程序必須將 Header 的成員設定為下列值：

類型

這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。

修訂版

這個成員必須設定為 DOT11_PHY_ID_LIST_REVISION_1。

大小

這個成員必須設定為sizeof (DOT11_PHY_ID_LIST) 。

如需這些成員的詳細資訊，請參閱 NDIS_OBJECT_HEADER。

uNumOfEntries

dot11PhyId 陣列中的項目數。

uTotalNumOfEntries

dot11PhyId 數位可以包含的項目數目上限。

dot11PhyId[1]

PHY 識別碼的清單 (識別碼) 。

備註

dot11PhyId 陣列中的 PHY 識別碼必須是下列其中一項：

• 原生 802.11 Operational msDot11SupportedPhyTypes 管理資訊基底 (MIB) 物件所定義之支援的 PHY 數據表索引。 如需 PHY 標識碼和 msDot11SupportedPhyTypes MIB 對象的詳細資訊，請參閱 OID_DOT11_SUPPORTED_PHY_TYPES。
• 值為 DOT11_PHY_ID_ANY 的 PHY 標識符。 此 PHY 識別碼稱為 通配符 PHY 識別符 ，可用來在 802.11 站上指定任何支援的 PHY。 如果使用通配符 PHY 標識碼，它必須是 dot11PhyId 陣列中唯一的專案。

查詢這些 OID 時，迷你埠驅動程式必須確認 MiniportOidRequest 函式 OidRequest 參數的 InformationBuffer 成員夠大，足以傳回整個DOT11_PHY_ID_LIST結構，包括 dot11PhyId 數位中的所有專案。 OidRequest 參數之 InformationBufferLength 成員的值會決定迷你埠驅動程式必須執行的動作，如下列清單所示：

• 如果 InformationBufferLength 成員的值小於整個DOT11_PHY_ID_LIST結構的長度，以位元組為單位，迷你埠驅動程式必須執行下列動作：
  • 將 uNumOfEntries 成員設定為零。
  • 將 uTotalNumOfEntries 成員設定為 dot11PhyId 陣列中的項目數。
  • 針對 OidRequest 參數，將 BytesWritten 成員設定為零，並將 BytesNeeded 成員設定為整個 DOT11_PHY_ID_LIST 結構的長度，以位元組為單位。
  • 從 其MiniportOidRequest 函式傳回NDIS_STATUS_BUFFER_OVERFLOW，使查詢要求失敗。
• 如果 InformationBufferLength 成員的值大於或等於整個DOT11_PHY_ID_LIST結構的長度，以位元組為單位，迷你埠驅動程式必須執行下列動作，才能完成成功的查詢要求：
  • 針對DOT11_PHY_ID_LIST結構，請將 uNumOfEntries 和 uTotalNumOfEntries 成員設定為 dot11PhyId 陣列中的項目總數。
  • 針對 OidRequest 參數，將 BytesNeeded 成員設定為零，並將 BytesWritten 成員設定為整個DOT11_PHY_ID_LIST結構的長度，以位元組為單位。 迷你埠驅動程式也必須將整個DOT11_PHY_ID_LIST結構複製到 InformationBuffer 成員。
  • 從 其MiniportOidRequest 函式傳回NDIS_STATUS_SUCCESS。

規格需求

另請參閱

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER