DOT11_EXTSTA_SEND_CONTEXT 結構 (windot11.h)

發行項
03/05/2024

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 WLAN 設備驅動器介面 (WDI) 。如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

DOT11_EXTSTA_SEND_CONTEXT 結構會定義由在 Extensible Station (ExtSTA) 模式中運作的迷你埠驅動程式所要傳送之封包的 Native 802.11 屬性。如需此作業模式的詳細資訊，請參閱可延伸月臺作業模式。

語法

typedef struct DOT11_EXTSTA_SEND_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  USHORT             usExemptionActionType;
  ULONG              uPhyId;
  ULONG              uDelayedSleepValue;
  PVOID              pvMediaSpecificInfo;
  ULONG              uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;

成員

Header

DOT11_EXTSTA_SEND_CONTEXT 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

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

類型

此成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。

修訂版

此成員必須設定為 DOT11_EXTSTA_SEND_CONTEXT_REVISION_1。

大小

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

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

usExemptionActionType

封包的加密豁免類型。定義下列豁免類型：

DOT11_EXEMPT_NO_EXEMPTION

封包不會豁免 802.11 月台執行的任何加密作業。

DOT11_EXEMPT_ALWAYS

封包會豁免 802.11 月台執行的任何加密作業。 802.11 月台必須傳輸未加密的封包。

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

只有在月台沒有封包目的地媒體訪問控制的密鑰對應金鑰， (MAC) 位址時，封包才會豁免 802.11 站所執行的任何加密作業。如需金鑰對應金鑰的詳細資訊，請參閱 802.11 加密金鑰類型。

uPhyId

802.11 站臺上 PHY 類型的標識碼 (標識子) 。 802.11 月台必須使用指定的 PHY 來傳輸封包。

uPhyId 的值必須是下列其中一項：

msDot11ActivePhyList MIB 物件所定義作用中 PHY 類型清單中的專案值。迷你埠驅動程式會將此MIB物件設定為已啟動以用於目前基本服務集的 PHY 清單， (BSS) 網路連線。如需 msDot11ActivePhyList MIB 對象的詳細資訊，請參閱 OID_DOT11_ACTIVE_PHY_LIST。
DOT11_PHY_ID_ANY的值，在此情況下，802.11 站可以從 msDot11ActivePhyList MIB 物件所定義的作用中 PHY 清單使用任何 PHY。

如果 不支援 uPhyId 指定的 PHY ，或已透過獨立硬體廠商實作的專屬機制， (IHV) ，迷你埠驅動程式必須失敗傳送要求。在此情況下，迷你埠驅動程式會將NET_BUFFER_LIST結構的 Status 成員設定為NDIS_STATUS_UNSUPPORTED_MEDIA和呼叫 NdisMSendNetBufferListsComplete 以完成傳送要求。

uDelayedSleepValue

在預期封包的回應之前，以微秒為單位的時間。只有在下列所有專案都成立時， uDelayedSleepValue 成員才有效：

封包是 (MAC) 服務數據單位 (MSDU) 封包的媒體存取控制。
802.11 月臺是以省電模式 (PS) 模式運作。在此情況下，Extensible Station (ExtSTA) msDot11PowerSavingLevel 管理資訊基底 (MIB) 物件具有任何值，但DOT11_POWER_SAVING_NO_POWER_SAVING除外。如需 msDot11PowerSavingLevel MIB 值的詳細資訊，請參閱 OID_DOT11_POWER_MGMT_REQUEST。

802.11 月臺使用 uDelayedSleepValue 的值來優化網路效能，同時以 PS 模式運作。例如，視 PS 模式而定，如果 uDelayedSleepValue 很小，802.11 月臺可能會讓無線電在封包傳輸之後保持開啟。如此一來，將減少接收回應的網路等待時間。

pvMediaSpecificInfo

緩衝區的指標，其中包含媒體特定資訊。當與此結構相關聯的 802.11 NET_BUFFER_LIST 結構來自原生 802.11 架構本身時，此成員應該是 NULL， (包括來自 IHV 延伸模組) 的任何NET_BUFFER_LIST結構。

否則，pvMediaSpecificInfo 會指向原始 802.3 NET_BUFFER_LIST 結構之 NetBufferListInfo 成員上與 MediaSpecificInformation 專案相關聯的頻外 (OOB) 數據。 pvMediaSpecificInfo 可讓迷你埠驅動程式從 IHV 特定 802.3 通訊協定驅動程式存取媒體特定資訊。

uSendFlags

定義傳送屬性的一組旗標。目前沒有定義旗標。此成員應為零。

備註

迷你埠驅動程式會在其執行傳送作業會呼叫 MiniportSendNetBufferLists 。透過此函式傳遞至驅動程式的每個封包都是由 NET_BUFFER_LIST 結構定義，其中包含原生 802.11 頻外 (OOB) 數據。 OOB 數據包含 802.11 站在傳輸封包時所使用的媒體特定參數。

迷你埠驅動程式會透過 NET_BUFFER_LIST_INFO 宏，使用下列參數存取 Native 802.11 OOB 數據：