DOT11_BSS_ENTRY 구조체(windot11.h)

아티클
02/27/2024

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

DOT11_BSS_ENTRY 구조는 마지막 검사 작업 중에 802.11 스테이션이 수신한 IEEE 802.11 비콘 또는 응답 프레임을 정의합니다.

구문

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

멤버

uPhyId

802.11 스테이션이 BSS 네트워크를 검색하는 데 사용한 PHY의 식별자(ID)입니다. PHY ID는 OID_DOT11_SUPPORTED_PHY_TYPES 쿼리를 통해 드라이버가 반환하는 지원되는 PHY 목록 내의 인덱스입니다.

이 ID는 DOT11_PHY_ID_ANY 않아야 합니다.

PhySpecificInfo

uPhyId 멤버가 참조하는 PHY의 특성입니다. PhySpecificInfo 는 로 형식이 지정됩니다. DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO 공용 구조체.

dot11BSSID

스캔하는 동안 802.11 스테이션에서 수신한 802.11 비콘 또는 프로브 응답 프레임을 전송한 액세스 지점(AP)(인프라 BSS 네트워크용) 또는 피어 스테이션(독립 BSS 네트워크의 경우)의 MAC(미디어 액세스 제어) 주소입니다. 이 멤버의 데이터 형식은 DOT11_MAC_ADDRESS 구조체입니다.

dot11BSSType

BSS 네트워크 유형입니다.

이 멤버의 데이터 형식은 DOT11_BSS_TYPE 열거형입니다. 미니포트 드라이버는 이 멤버를 dot11_BSS_type_any 값으로 설정해서는 안됩니다.

lRSSI

AP 또는 피어 스테이션의 802.11 스테이션에서 감지한 바와 같이 수신된 RSSI(신호 강도 지표) 값은 1.0밀리와트(dBm)로 참조되는 데시벨 단위입니다.

uLinkQuality

0에서 100 사이의 링크 품질 값입니다. 값 100은 가장 높은 링크 품질을 지정합니다. 링크 품질을 결정하는 방법에 대한 자세한 내용은 링크 품질 작업을 참조하세요.

bInRegDomain

이 멤버는 AP 또는 피어 스테이션이 입력 국가 문자열로 식별된 대로 규정 도메인 내에서 작동하고 있는지 여부를 지정합니다. 이 멤버를 설정하려면 미니포트 드라이버에서 다음 지침을 사용해야 합니다.

802.11 스테이션이 여러 규제 도메인을 지원하지 않는 경우 멤버를 TRUE로 설정합니다. 여러 규제 도메인에 대한 자세한 내용은 OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
입력 국가 문자열이 모두 0이면 멤버를 TRUE로 설정합니다.
AP 또는 피어 스테이션이 입력 국가 문자열로 지정된 규정 도메인에 유효한 채널에서 작동하지 않는 경우 멤버를 FALSE로 설정합니다.
AP 또는 피어 스테이션에서 받은 802.11 비콘 또는 프로브 응답 프레임에 IE(국가 정보 요소)가 포함되지 않은 경우 멤버를 TRUE로 설정합니다.
Country IE에 대한 자세한 내용은 IEEE 802.11d-2001 표준의 절 7.3.2.12를 참조하세요.
AP 또는 피어 스테이션에서 받은 802.11 비콘 또는 프로브 응답 프레임에 Country IE가 포함된 경우 Country String 하위 필드의 값이 입력 국가 문자열과 같지 않으면 멤버를 FALSE 로 설정합니다.
다른 모든 경우에서 멤버를 TRUE 로 설정합니다.

usBeaconPeriod

802.11 비콘 또는 프로브 응답 프레임의 비콘 간격 필드 값입니다.

ullTimestamp

802.11 비콘 또는 프로브 응답 프레임의 타임스탬프 필드 값입니다.

ullHostTimestamp

NdisGetCurrentSystemTime에 대한 호출을 통해 해결된 타임스탬프는 802.11 스테이션이 802.11 비콘 또는 프로브 응답 프레임을 받았을 때를 기록합니다.

usCapabilityInformation

802.11 비콘 또는 프로브 응답 프레임의 기능 정보 필드 값입니다.

uBufferLength

DOT11_BSS_ENTRY 구조체의 ucBuffer 배열 길이(바이트)입니다. ulBufferLength 는 ucBuffer 배열에 있는 데이터의 정확한 길이여야 하며 맞춤을 위한 패딩을 포함하지 않아야 합니다.

ucBuffer[1]

802.11 비콘 또는 프로브 응답 프레임의 가변 길이 정보 요소(ES)입니다. 각 BSS에 대해 ES는 해당 BSS 네트워크에서 받은 마지막 비콘 또는 프로브 응답 프레임에 있어야 합니다. IE를 한 프레임에서만 사용할 수 있는 경우 미니포트 드라이버는 마지막으로 받은 비콘 또는 프로브 응답 프레임의 다른 IE와 IE를 병합해야 합니다.

NIC가 ExtAP(확장 가능한 액세스 지점) OP 모드에 있는 경우 BSS 목록에는 NIC가 만든 BSS에 대한 항목이 포함되어야 합니다.

IEEE 802.11 비콘 또는 프로브 응답 프레임 내의 필드에 대한 자세한 내용은 IEEE 802.11-2012 표준의 절 8.4를 참조하세요.

설명

802.11 스테이션이 스캔 작업을 수행하면 Native 802.11 미니포트 드라이버는 수신된 802.11 비콘 및 프로브 응답 프레임을 캐시합니다. 검사 작업에 대한 자세한 내용은 네이티브 802.11 검사 작업을 참조하세요.

802.11 스테이션이 스캔 작업을 완료한 후 미니포트 드라이버는 OID_DOT11_ENUM_BSS_LIST 쿼리할 때 캐시된 비콘 및 프로브 응답 프레임 목록을 반환합니다. 별도의 DOT11_BSS_ENTRY 구조체는 각 비콘 및 프로브 응답 프레임에 대해 형식이 지정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	windot11.h(Ndis.h 포함)