DOT11_WFD_DISCOVER_REQUEST構造 (windot11.h)

[アーティクル]
02/27/2024

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

OID_DOT11_WFD_DISCOVER_REQUEST構造体は、OID_DOT11_WFD_DISCOVER_REQUEST要求の入力データです。構造体には、Wi-Fi ダイレクトデバイス検出のパラメーターが含まれています。

構文

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 構造体として書式設定されます。

ミニポートドライバーは 、ヘッダー のメンバーを次の値に設定する必要があります。

型

このメンバーは 、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 デバイスフィルターの一覧へのオフセット。これは、ダイレクトデバイスの検出中に検索する P2P デバイスとグループ所有者 Wi-Fi 指定します。このオフセットはバイト単位で指定され、DOT11_WFD_DISCOVER_REQUEST構造体を含むバッファーの先頭を基準にしています。リスト内の各エントリは、DOT11_WFD_DISCOVER_DEVICE_FILTERとして書式設定されます。

リストエントリで非ブロードキャスト MAC アドレスがデバイス ID として指定されている場合、ドライバーは、プローブ要求に含まれる P2P IEs のデバイス ID 属性でこの MAC アドレスを使用する必要があります。

P2P デバイス識別子のリストが始まるNDIS_OID_REQUESTの InformationBuffer 内のオフセット。これらは、デバイスの検出中に使用する識別子です。

uNumDeviceFilters

WFD デバイス検出中に使用する P2P デバイスフィルターの数。このフィールドの既定値は 0 です。

uIEsOffset

追加の Informational Elements (IE) が開始されるNDIS_OID_REQUEST構造体の InformationBuffer 内のオフセット。

uIEsLength

Wi-Fi ダイレクトデバイスポートがプローブ要求パケットに追加する必要がある追加の IEs の長さ (バイト単位)。この値が 0 の場合、システムは IEs を提供せず、ミニポートはプローブ要求パケットに既定の IEs を挿入する必要があります。既定の IE は、OID_DOT11_WFD_ADDITIONAL_IE要求で先ほど受信した DefaultRequestIEs にあります。

bForceScanLegacyNetworks

TRUE の場合、Wi-Fi Direct デバイスもレガシネットワークの検出を試みる必要があります。それ以外の場合は、レガシネットワークのスキャンは必要ありません。

注釈

uDeviceFilterListOffset のデバイス識別子リストの各エントリは、DOT11_MAC_ADDRESS構造体として書式設定されます。この一覧で非ブロードキャスト MAC アドレスが指定されている場合、ドライバーは、送信する P2P IEs プローブ要求のデバイス ID 属性でこのアドレスを使用する必要があります

uIEsOffset に存在する IEs は、デバイス検出の期間中、OID_DOT11_WFD_ADDITIONAL_IE要求の入力構造の DefaultRequestIEs で見つかった IEs を一時的に置き換えます。