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 ダイレクト デバイス検出のパラメーターが含まれています。
構文
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 要素 (IEs) が開始される 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 を一時的に置き換えます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 のバージョン:_Supported |
| ヘッダー | windot11.h (Windot11.h を含む) |