DOT11_WFD_DISCOVER_REQUEST 구조체(windot11.h)

아티클
02/07/2025

중요하다

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설정해야 합니다.

크기

이 멤버는 (DOT11_SIZEOF_WFD_DISCOVER_REQUEST_REVISION_1)의sizeof로 설정해야 합니다.

이러한 멤버에 대한 자세한 내용은 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 주소를 사용해야 합니다.

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

uNumDeviceFilters

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

uIEsOffset

InformationBuffer의 오프셋은 추가 정보 요소(ES)가 시작되는 NDIS_OID_REQUEST 구조체의.

uIEsLength

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

bForceScanLegacyNetworks

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

발언

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

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