DOT11_WFD_DISCOVER_REQUEST 구조체(windot11.h)

아티클
08/08/2023

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. 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 IDE의 디바이스 ID 특성에서 이 MAC 주소를 사용해야 합니다.

P2P 디바이스 식별자 목록이 시작되는 NDIS_OID_REQUESTInformationBuffer의 오프셋입니다. 디바이스를 검색하는 동안 사용할 식별자입니다.

uNumDeviceFilters

WFD 디바이스 검색 중에 사용할 P2P 디바이스 필터 수입니다. 이 필드의 기본값은 0입니다.

uIEsOffset

추가 정보 요소(ES)가 시작되는 NDIS_OID_REQUEST 구조체의 InformationBuffer에 있는 오프셋입니다.

uIEsLength

Wi-Fi Direct 디바이스 포트가 프로브 요청 패킷에 추가해야 하는 추가 ES의 길이(바이트)입니다. 이 값이 0이면 시스템에서 ES를 제공하지 않았으며 미니포트는 프로브 요청 패킷에 기본 ES를 삽입해야 합니다. 기본 ES는 OID_DOT11_WFD_ADDITIONAL_IE 요청으로 이전에 받은 DefaultRequestIE에 있습니다.

bForceScanLegacyNetworks

TRUE이면 Wi-Fi 직접 디바이스도 레거시 네트워크를 검색하려고 시도해야 합니다. 그렇지 않으면 레거시 네트워크를 검사할 필요가 없습니다.

설명

uDeviceFilterListOffset의 디바이스 식별자 목록에 있는 각 항목은 DOT11_MAC_ADDRESS 구조로 형식이 지정됩니다. 이 목록에 브로드캐스트되지 않은 MAC 주소가 지정된 경우 드라이버는 전송하는 P2P IDE 프로브 요청의 디바이스 ID 특성에서 이 주소를 사용해야 합니다.

디바이스 검색 기간 동안 uIEsOffset에 있는 ES는 OID_DOT11_WFD_ADDITIONAL_IE 요청의 입력 구조에서 DefaultRequestIEs에 있는 ES를 일시적으로 대체합니다.