共用方式為


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

大小

這個成員必須設定為 sizeofDOT11_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 會暫時取代在 DefaultRequestIEsOID_DOT11_WFD_ADDITIONAL_IE 要求輸入結構中找到的 IES。

要求

要求 價值
最低支援的用戶端 Windows 8 中的版本:_Supported
標頭 windot11.h (包括 Windot11.h)

另請參閱

OID_DOT11_WFD_DISCOVER_REQUEST

DOT11_WFD_SCAN_TYPE

DOT11_WFD_DISCOVER_TYPE

NDIS_OBJECT_HEADER