DOT11_WFD_DISCOVER_REQUEST結構(windot11.h)
重要
WiFiCx 是 Windows 11 中發行的新 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。 WDI 驅動程式模型現在處於維護模式,而且只會收到高優先順序的修正。
OID_DOT11_WFD_DISCOVER_REQUEST 結構是 OID_DOT11_WFD_DISCOVER_REQUEST 要求的輸入數據。 結構包含 Wi-Fi Direct 裝置探索的參數。
語法
typedef struct _DOT11_WFD_DISCOVER_REQUEST {
NDIS_OBJECT_HEADER Header;
DOT11_WFD_DISCOVER_TYPE DiscoverType;
DOT11_WFD_SCAN_TYPE ScanType;
ULONG uDiscoverTimeout;
ULONG uDeviceFilterListOffset;
ULONG uNumDeviceFilters;
ULONG uIEsOffset;
ULONG uIEsLength;
BOOLEAN bForceScanLegacyNetworks;
} DOT11_WFD_DISCOVER_REQUEST, *PDOT11_WFD_DISCOVER_REQUEST;
成員
Header
OID_DOT11_WFD_DISCOVER_REQUEST 結構的型別、修訂和大小。 此成員的格式為 NDIS_OBJECT_HEADER 結構。
迷你埠驅動程序必須將 Header 的成員設定為下列值:
類型
這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。
校訂
這個成員必須設定為 DOT11_WFD_DISCOVER_REQUEST_REVISION_1。
大小
這個成員必須設定為 sizeof(DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1)。
如需這些成員的詳細資訊,請參閱 NDIS_OBJECT_HEADER。
DiscoverType
要使用的裝置探索模式。
ScanType
在裝置探索掃描階段中使用的掃描類型。
uDiscoverTimeout
完成探索作業的時間上限,以毫秒為單位。 迷你埠可以在較少的時間內完成探索,不過,不應使用比此值指定的時間還要多的時間。 這是裝置探索所有階段完成所允許的總時間。
uDeviceFilterListOffset
P2P 裝置篩選清單的位移,指定要在 Wi-Fi 直接裝置探索期間搜尋的 P2P 裝置和群組擁有者。 這個位移是以位元組指定,且相對於包含DOT11_WFD_DISCOVER_REQUEST結構的緩衝區開頭。 清單中的每個項目都會格式化為DOT11_WFD_DISCOVER_DEVICE_FILTER。
當清單專案將非廣播 MAC 位址指定為裝置識別碼時,驅動程式必須在探查要求中所包含的 P2P IES 的 [裝置識別元屬性] 中使用這個 MAC 位址。
InformationBufferNDIS_OID_REQUEST 中開始 P2P 裝置識別碼清單的位移。 這些是裝置探索期間要用於的標識碼。
uNumDeviceFilters
WFD 裝置探索期間要使用的 P2P 裝置篩選數目。 此欄位的預設值為 0。
uIEsOffset
InformationBuffer 中NDIS_OID_REQUEST 結構中開始其他資訊元素的位移。
uIEsLength
Wi-Fi Direct 裝置埠必須新增至探查要求封包的額外 IE 長度,以位元組為單位。 如果此值為 0,系統未提供任何 IE,而且迷你埠必須在探查要求封包中插入預設 IE。 默認 IE 位於先前收到 OID_DOT11_WFD_ADDITIONAL_IE 要求 DefaultRequestIEs。
bForceScanLegacyNetworks
當為TRUE時,Wi-Fi 直接裝置也必須嘗試探索舊版網路。 否則,不需要掃描舊版網路。
言論
uDeviceFilterListOffset 裝置識別符清單中的每個項目都會格式化為 DOT11_MAC_ADDRESS 結構。 在此清單中指定非廣播 MAC 位址時,驅動程式必須在 P2P IES 探查要求的裝置識別碼屬性中使用這個位址
在裝置探索期間,uIEsOffset的 IES 會暫時取代在 DefaultRequestIEs 中 OID_DOT11_WFD_ADDITIONAL_IE 要求輸入結構中找到的 IES。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 中的版本:_Supported |
標頭 | windot11.h (包括 Windot11.h) |