DOT11EXT_SET_ETHERTYPE_HANDLING 콜백 함수(wlanihv.h)

아티클
08/08/2023

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

IHV 확장 DLL은 Dot11ExtSetEtherTypeHandling 함수를 호출하여 다음을 수행합니다.

패킷 암호 해독 예외 목록을 사용하여 WLAN(무선 LAN) 어댑터를 구성합니다. 각 예외는 수신된 패킷의 IEEE EtherType에 따라 적용됩니다.
Dot11ExtIhvReceivePacket IHV 처리기 함수에 대한 호출을 통해 IHV 확장 DLL로 전달될 수신된 패킷의 EtherTypes에 대한 운영 체제에 등록합니다.

구문

DOT11EXT_SET_ETHERTYPE_HANDLING Dot11extSetEthertypeHandling;

DWORD Dot11extSetEthertypeHandling(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uMaxBackLog,
  [in]           ULONG uNumOfExemption,
  [in, optional] PDOT11_PRIVACY_EXEMPTION pExemption,
  [in]           ULONG uNumOfRegistration,
  [in, optional] USHORT *pusRegistration
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

운영 체제에서 WLAN 어댑터를 참조하는 데 사용하는 핸들입니다. 이 핸들 값은 Dot11ExtIhvInitAdapter IHV 처리기 함수에 대한 이전 호출을 통해 지정되었습니다.

[in] uMaxBackLog

IHV 확장 DLL이 Dot11ExtIhvReceivePacket IHV 처리기 함수에 대한 호출에서 반환되지 않은 경우 운영 체제에서 큐에 대기하는 최대 수신 패킷 수입니다. uMaxBackLog에 도달하면 운영 체제는 큐에서 가장 오래된 패킷을 삭제합니다.

[in] uNumOfExemption

pExemption 매개 변수에서 참조하는 개인 정보 예외 배열 내의 항목 수입니다. 값이 0이면 WLAN 어댑터에서 개인 정보 예외가 비활성화됩니다.

[in, optional] pExemption

개인 정보 예외 배열에 대한 포인터입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_PRIVACY_EXEMPTION 구조체입니다.

[in] uNumOfRegistration

pusRegistration 매개 변수에서 참조하는 IEEE EtherType 등록 배열 내의 항목 수입니다. 값이 0이면 Dot11ExtIhvReceivePacket IHV 처리기 함수에 대한 호출을 통해 모든 패킷을 수신하는 IHV 확장 DLL의 기능이 비활성화됩니다.

[in, optional] pusRegistration

IEEE EtherType 등록 배열에 대한 포인터입니다. 각 항목에는 big-endian 형식의 EtherType 값이 있습니다.

반환 값

호출이 성공하면 함수는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 Winerror.h에 정의된 오류 코드를 반환합니다.

설명

Dot11ExtSetEtherTypeHandling 함수를 호출할 때 IHV 확장 DLL은 다음 지침을 따라야 합니다.

IHV 확장 DLL은 Dot11ExtIhvInitAdapter 또는 호출 내에서 Dot11ExtSetEtherTypeHandling 을 호출할 수 있습니다. Dot11ExtIhvPerformPreAssociate IHV 처리기 함수입니다.
IHV 확장 DLL은 호출을 통해 사전 연결 작업을 성공적으로 완료한 후 Dot11ExtSetEtherTypeHandling 을 호출해서는 안 됩니다. Dot11ExtPreAssociateCompletion.

운영 체제는 기본적으로 Dot11ExtIhvInitAdapter IHV 처리기 함수를 호출하기 전에 개인 정보 보호 예외 및 EtherType 등록의 빈 목록으로 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	wlanihv.h(Wlanihv.h 포함)