DOT11_PHY_ATTRIBUTES 구조체(windot11.h)

아티클
08/08/2023

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

DOT11_PHY_ATTRIBUTES 구조체는 802.11 스테이션에서 PHY의 물리적 및 작동 특성을 정의합니다.

구문

typedef struct DOT11_PHY_ATTRIBUTES {
  NDIS_OBJECT_HEADER                  Header;
  DOT11_PHY_TYPE                      PhyType;
  BOOLEAN                             bHardwarePhyState;
  BOOLEAN                             bSoftwarePhyState;
  BOOLEAN                             bCFPollable;
  ULONG                               uMPDUMaxLength;
  DOT11_TEMP_TYPE                     TempType;
  DOT11_DIVERSITY_SUPPORT             DiversitySupport;
  union {
    DOT11_HRDSSS_PHY_ATTRIBUTES HRDSSSAttributes;
    DOT11_OFDM_PHY_ATTRIBUTES   OFDMAttributes;
    DOT11_ERP_PHY_ATTRIBUTES    ERPAttributes;
  };
  ULONG                               uNumberSupportedPowerLevels;
  ULONG                               TxPowerLevels[8];
  ULONG                               uNumDataRateMappingEntries;
  DOT11_DATA_RATE_MAPPING_ENTRY       DataRateMappingEntries[DOT11_RATE_SET_MAX_LENGTH];
  DOT11_SUPPORTED_DATA_RATES_VALUE_V2 SupportedDataRatesValue;
} DOT11_PHY_ATTRIBUTES, *PDOT11_PHY_ATTRIBUTES;

멤버

Header

DOT11_PHY_ATTRIBUTES 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.

형식

이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.

수정 버전

이 멤버는 DOT11_PHY_ATTRIBUTES_REVISION_1 설정해야 합니다.

크기

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

이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER.

PhyType

DOT11_PHY_TYPE 열거자 값으로 지정된 PHY의 형식입니다.

bHardwarePhyState

PHY의 하드웨어 전원 상태를 지정하는 부울 값입니다. TRUE이면 하드웨어 전원 상태가 사용하도록 설정됩니다. FALSE이면 하드웨어 전원 상태가 비활성화됩니다.

PHY의 하드웨어 전원 상태에 대한 자세한 내용은 OID_DOT11_HARDWARE_PHY_STATE.

참고 PHY의 하드웨어 전원 상태가 변경되면 미니포트 드라이버는 미디어별 상태 표시를 NDIS_STATUS_DOT11_PHY_STATE_CHANGED.

bSoftwarePhyState

PHY의 소프트웨어 전원 상태를 지정하는 부울 값입니다. TRUE이면 소프트웨어 전원 상태가 사용하도록 설정됩니다. FALSE이면 소프트웨어 전원 상태가 비활성화됩니다.

PHY의 소프트웨어 전원 상태에 대한 자세한 내용은 OID_DOT11_NIC_POWER_STATE 참조하세요.

참고 PHY의 소프트웨어 전원 상태가 변경되면 미니포트 드라이버는 미디어별 상태 표시를 NDIS_STATUS_DOT11_PHY_STATE_CHANGED.

bCFPollable

TRUE로 설정된 경우 802.11 스테이션이 CF-Poll 프레임을 지원한다는 것을 나타내는 부울 값입니다. CF-Poll 프레임에 대한 자세한 내용은 IEEE 802.11-2012 표준의 절 9.4를 참조하세요.

이 멤버는 ExtAP(Extensible Access Point) 작업 모드에 적용되지 않으며 NIC가 ExtAP 모드에 있을 때 무시됩니다.

uMPDUMaxLength

PHY가 전송하거나 받을 수 있는 MAC(미디어 액세스 제어) MPDU(프로토콜 데이터 단위) 프레임의 최대 길이(바이트)입니다. 자세한 내용은 OID_DOT11_MPDU_MAX_LENGTH.

참고 PHY의 소프트웨어 전원 상태가 변경되면 미니포트 드라이버는 미디어별 상태 표시를 NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED 합니다.

TempType

DOT11_TEMP_TYPE 열거형 값을 통해 정의된 PHY의 작동 온도 범위입니다.

DiversitySupport

DOT11_DIVERSITY_SUPPORT 열거형 값을 통해 정의된 PHY의 안테나 다양성 유형입니다.

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

높은 속도의 HRDSS(직접 시퀀스 확산 스펙트럼) PHY 유형의 PHY별 특성입니다. 미니포트 드라이버는 PhyType 멤버가 dot11_phy_type_hrdsss 설정된 경우에만 이 멤버를 사용해야 합니다.

PhySpecificAttributes.OFDMAttributes

OFDM(직교 주파수 나누기 멀티플렉싱) PHY 유형의 PHY별 특성입니다. 미니포트 드라이버는 PhyType 멤버가 dot11_phy_type_ofdm 설정된 경우에만 이 멤버를 사용해야 합니다.

PhySpecificAttributes.ERPAttributes

ERP(확장 속도 PHY) 형식의 PHY별 특성입니다. 미니포트 드라이버는 PhyType 멤버가 dot11_phy_type_erp 설정된 경우에만 이 멤버를 사용해야 합니다.

설명

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 구조체에는 DOT11_PHY_ATTRIBUTES 구조체 배열의 주소를 지정하는 멤버(pExtPhyAttributes)가 포함되어 있습니다. 미니포트 드라이버가 NdisMSetMiniportAttributes를 호출하면 드라이버는 MiniportAttributes 매개 변수를 DOT11_PHY_ATTRIBUTES 구조의 배열과 함께 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 구조체를 포함하는 드라이버 할당 메모리 블록의 주소로 설정합니다.

요구 사항

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