DOT11EXTIHV_QUERY_UI_REQUEST 콜백 함수(wlanihv.h)

아티클
08/08/2023

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

운영 체제는 연결 상태 변경 될 때마다 Dot11ExtIhvQueryUIRequest 함수를 호출합니다. 이 함수가 호출되면 IHV 확장 DLL은 운영 체제가 UI 요청에 사용할 수 있는 DOT11EXT_IHV_UI_REQUEST 구조를 반환합니다.

구문

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

매개 변수

[in, optional] hIhvExtAdapter

IHV 확장 DLL에서 WLAN(무선 LAN) 어댑터를 참조하는 데 사용하는 핸들입니다. 이 핸들 값은 Dot11ExtIhvInitAdapter IHV 처리기 함수에 대한 이전 호출을 통해 지정되었습니다.

[in] connectionPhase

현재 연결 단계입니다. 이 멤버의 데이터 형식은 DOT11EXT_IHV_CONNECTION_PHASE 열거형입니다.

connection_phase_any

연결 단계를 지정합니다.

connection_phase_initial_connection

IHV 확장 DLL이 사전 연결 작업을 시작하기 전에 연결 단계를 지정합니다. 사전 연결 작업에 대한 자세한 내용은 사전 연결 작업을 참조하세요.

connection_phase_post_l3_connection

IHV 확장 DLL이 연결 후 작업을 완료한 후 연결 단계를 지정합니다. 연결 후 작업에 대한 자세한 내용은 연결 후 작업을 참조하세요.

[out] ppIhvUIRequest

DOT11EXT_IHV_UI_REQUEST 구조체에 대한 포인터의 주소입니다. IHV 확장 DLL은 Dot11ExtAllocateBuffer를 호출하여 DOT11EXT_IHV_UI_REQUEST 구조체에 대한 버퍼를 할당해야 합니다.

반환 값

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

설명

Dot11ExtIhvQueryUIRequest가 호출되면 IHV 확장 DLL은 DOT11EXT_IHV_UI_REQUEST 구조체로 형식이 지정된 버퍼를 할당하고 반환해야 합니다. 이 경우 DLL은 다음 지침을 따라야 합니다.

IHV 확장 DLL은 Dot11ExtAllocateBuffer 를 호출하여 버퍼를 할당해야 합니다. DLL이 Dot11ExtIhvQueryUIRequest에서 반환된 후 운영 체제는 Dot11ExtFreeBuffer 를 호출하여 버퍼를 해제합니다.
IHV 확장 DLL은 연결 상태 변경에 적합한 UI 요청에 대한 DOT11EXT_IHV_UI_REQUEST 구조 형식을 지정합니다.
예를 들어 connectionPhase 가 connection_phase_initial_connection 설정된 경우 IHV 확장 DLL은 연결 작업의 시작을 사용자에게 알릴 사용자 인터페이스 페이지를 참조하도록 DOT11EXT_IHV_UI_REQUEST 구조체의 멤버를 설정할 수 있습니다.

요구 사항

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