PFN_WSK_CLIENT_EVENT 콜백 함수(wsk.h)

WskClientEvent 이벤트 콜백 함수는 WSK 애플리케이션에 특정 소켓과 관련이 없는 이벤트에 대해 알 수 있습니다.

구문

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

NTSTATUS PfnWskClientEvent(
  [in, optional] PVOID ClientContext,
  [in]           ULONG EventType,
  [in, optional] PVOID Information,
  [in]           SIZE_T InformationLength
)
{...}

매개 변수

[in, optional] ClientContext

WskRegister 함수에 전달된 WskClientNpi 매개 변수에 의해 지정된 컨텍스트 값에 대한 포인터입니다.

[in] EventType

WSK 애플리케이션에 알림을 받는 특정 이벤트입니다. 현재 정의된 이벤트가 없습니다.

[in, optional] Information

이벤트와 연결된 추가 정보가 포함된 버퍼에 대한 포인터입니다. 이벤트와 관련된 추가 정보가 없으면 이 포인터는 NULL이 됩니다.

[in] InformationLength

가 가리키는 버퍼에 포함된 추가 정보의 길이입니다.
정보 매개 변수입니다. 이벤트와 관련된 추가 정보가 없으면 이 값은 0이 됩니다.

반환 값

WSK 애플리케이션의 WskClientEvent 이벤트 콜백 함수는 다음 NTSTATUS 코드 중 하나를 반환할 수 있습니다.

반환 코드	설명
STATUS_SUCCESS	이벤트 알림이 성공적으로 처리되었습니다.
STATUS_NOT_IMPLEMENTED	Event 매개 변수에 전달된 이벤트에 대한 지원은 구현되지 않습니다.

설명

현재 WskClientEvent 이벤트 콜백 함수에 대해 정의된 이벤트는 없습니다. 따라서 WSK 애플리케이션이 WskClientEvent 이벤트 콜백 함수를 구현하는 경우 항상 STATUS_NOT_IMPLEMENTED 반환해야 합니다.

Information 매개 변수가 가리키는 버퍼에 포함된 추가 정보는 읽기 전용이며 WskClientEvent 이벤트 콜백 함수를 호출하는 동안에만 유효합니다.

WSK 애플리케이션이 WskClientEvent 이벤트 콜백 함수를 구현하지 않는 경우 WskRegister를 호출하기 전에 WSK_CLIENT_DISPATCH 구조체의 WskClientEvent 멤버를 NULL로 설정해야 합니다.

WSK 하위 시스템은 IRQL <= DISPATCH_LEVEL WSK 애플리케이션의 WskClientEvent 이벤트 콜백 함수를 호출합니다.

WSK 애플리케이션의 WskClientEvent 이벤트 콜백 함수는 WSK 완료 또는 이벤트 콜백 함수의 컨텍스트에서 다른 WSK 요청이 완료될 때까지 기다리지 않아야 합니다. 콜백은 다른 WSK 요청을 시작할 수 있지만(DISPATCH_LEVEL 시간이 너무 많이 소요되지 않는다고 가정) 콜백이 IRQL = PASSIVE_LEVEL 호출되는 경우에도 완료될 때까지 기다리지 않아야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	Windows
헤더	wsk.h(Wsk.h 포함)
IRQL	<= DISPATCH_LEVEL

추가 정보

WSK_CLIENT_DISPATCH

WskRegister