DOT11_EXTSTA_SEND_CONTEXT 구조체(windot11.h)

아티클
08/08/2023

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

DOT11_EXTSTA_SEND_CONTEXT 구조체는 ExtSTA(Extensible Station) 모드에서 작동하는 미니포트 드라이버가 보낼 패킷의 Native 802.11 특성을 정의합니다. 이 작업 모드에 대한 자세한 내용은 확장 가능한 스테이션 작업 모드를 참조하세요.

구문

typedef struct DOT11_EXTSTA_SEND_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  USHORT             usExemptionActionType;
  ULONG              uPhyId;
  ULONG              uDelayedSleepValue;
  PVOID              pvMediaSpecificInfo;
  ULONG              uSendFlags;
} DOT11_EXTSTA_SEND_CONTEXT, *PDOT11_EXTSTA_SEND_CONTEXT;

멤버

Header

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

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

형식

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

수정 버전

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

크기

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

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

usExemptionActionType

패킷에 대한 암호화 예외 유형입니다. 다음과 같은 예외 유형이 정의됩니다.

DOT11_EXEMPT_NO_EXEMPTION

패킷은 802.11 스테이션에서 수행하는 암호 작업에서 제외되지 않습니다.

DOT11_EXEMPT_ALWAYS

패킷은 802.11 스테이션에서 수행하는 암호 작업에서 제외됩니다. 802.11 스테이션은 암호화되지 않은 패킷을 전송해야 합니다.

DOT11_EXEMPT_ON_KEY_MAPPING_KEY_UNAVAILABLE

패킷의 MAC(대상 미디어 액세스 제어) 주소에 대한 키 매핑 키가 스테이션에 없는 경우에만 802.11 스테이션에서 수행하는 암호 작업에서 패킷이 제외됩니다. 키 매핑 키에 대한 자세한 내용은 802.11 암호 키 형식을 참조하세요.

uPhyId

802.11 스테이션의 PHY 형식 식별자(ID)입니다. 802.11 스테이션은 지정된 PHY를 사용하여 패킷을 전송해야 합니다.

uPhyId 값은 다음 중 하나여야 합니다.

msDot11ActivePhyList MIB 개체에 의해 정의된 활성 PHY 형식 목록의 항목 값입니다. 미니포트 드라이버는 이 MIB 개체를 현재 BSS(기본 서비스 집합) 네트워크 연결을 통해 사용하도록 활성화된 PHY 목록으로 설정합니다. msDot11ActivePhyList MIB 개체에 대한 자세한 내용은 OID_DOT11_ACTIVE_PHY_LIST.
DOT11_PHY_ID_ANY 값입니다. 이 경우 802.11 스테이션은 msDot11ActivePhyList MIB 개체에 의해 정의된 활성 PHY 목록의 모든 PHY를 사용할 수 있습니다.

uPhyId로 지정된 PHY가 지원되지 않거나 IHV(독립 하드웨어 공급업체)에서 구현한 독점 메커니즘을 통해 사용하지 않도록 설정된 경우 미니포트 드라이버는 송신 요청에 실패해야 합니다. 이 경우 미니포트 드라이버는 NET_BUFFER_LIST 구조체의 Status 멤버를 NDIS_STATUS_UNSUPPORTED_MEDIA 및 호출로 설정합니다. NdisMSendNetBufferListsComplete 를 사용하여 보내기 요청을 완료합니다.

uDelayedSleepValue

패킷에 대한 응답이 예상되기 전의 시간(마이크로초)입니다. uDelayedSleepValue 멤버는 다음이 모두 true인 경우에만 유효합니다.

패킷은 MAC(미디어 액세스 제어) MSDU(서비스 데이터 단위) 패킷입니다.
802.11 스테이션은 PS(절전) 모드로 작동합니다. 이 경우 ExtSTA(Extensible Station) msDot11PowerSavingLevel MIB(관리 정보 베이스) 개체에는 DOT11_POWER_SAVING_NO_POWER_SAVING 제외한 모든 값이 있습니다. msDot11PowerSavingLevel MIB 값에 대한 자세한 내용은 OID_DOT11_POWER_MGMT_REQUEST.

802.11 스테이션은 uDelayedSleepValue 값을 사용하여 PS 모드에서 작동하는 동안 네트워크 성능을 최적화합니다. 예를 들어 PS 모드에 따라 uDelayedSleepValue 가 작은 경우 802.11 스테이션은 패킷 전송 후 라디오를 계속 켤 수 있습니다. 이렇게 하면 응답을 수신하기 위한 네트워크 대기 시간이 줄어듭니다.

pvMediaSpecificInfo

미디어 관련 정보를 포함하는 버퍼에 대한 포인터입니다. 이 구조체가 연결된 802.11 NET_BUFFER_LIST 구조체가 네이티브 802.11 프레임워크 자체(IHV 확장에서 가져온 NET_BUFFER_LIST 구조 포함)에서 가져온 경우 이 멤버는 NULL이어야 합니다.

그렇지 않으면 pvMediaSpecificInfo는 원래 802.3 NET_BUFFER_LIST 구조체의 NetBufferListInfo 멤버에 있는 MediaSpecificInformation 항목과 연결된 OOB(out-of-band) 데이터를 가리킵니다. pvMediaSpecificInfo 를 사용하면 미니포트 드라이버가 IHV 관련 802.3 프로토콜 드라이버에서 미디어 관련 정보에 액세스할 수 있습니다.

uSendFlags

송신 특성을 정의하는 플래그 집합입니다. 현재 플래그가 정의되어 있지 않습니다. 이 멤버는 0이어야 합니다.

설명

미니포트 드라이버는 전송 시 송신 작업을 수행합니다. MiniportSendNetBufferLists 가 호출됩니다. 이 함수를 통해 드라이버에 전달된 각 패킷은 Native 802.11 OOB(Out of Band) 데이터를 포함하는 NET_BUFFER_LIST 구조로 정의됩니다. OOB 데이터에는 802.11 스테이션에서 패킷을 전송할 때 사용하는 미디어별 매개 변수가 포함되어 있습니다.

미니포트 드라이버는 다음 매개 변수를 사용하여 NET_BUFFER_LIST_INFO 매크로를 통해 Native 802.11 OOB 데이터에 액세스합니다.

수신된 802.11 패킷에 사용되는 NET_BUFFER_LIST 구조체에 포인터를 전달하는 _NBL 매개 변수입니다.
MediaSpecificInformation의 식별자(ID) 값을 전달하는 _ id 매개 변수입니다.

네이티브 802.11 보내기 작업에 대한 자세한 내용은 네이티브 802.11 보내기 작업을 참조하세요.

요구 사항

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