PFN_WSK_SEND_BACKLOG_EVENT 콜백 함수(wsk.h)

아티클
03/01/2024

WskSendBacklogEvent 이벤트 콜백 함수는 연결 지향 소켓에 대한 이상적인 보내기 백로그 크기가 변경될 때 WSK 애플리케이션에 알릴 수 있습니다.

구문

PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;

NTSTATUS PfnWskSendBacklogEvent(
  [in, optional] PVOID SocketContext,
  [in]           SIZE_T IdealBacklogSize
)
{...}

매개 변수

[in, optional] SocketContext

WSK 애플리케이션에 이상적인 송신 백로그 크기 변경에 대해 알리는 연결 지향 소켓의 소켓 컨텍스트에 대한 포인터입니다. WSK 애플리케이션은 다음 방법 중 하나로 WSK 하위 시스템에 대한 이 포인터를 제공했습니다.

소켓을 만들기 위해 WskSocket 함수를 호출했습니다.
소켓을 만들기 위해 WskSocketConnect 함수를 호출했습니다.
소켓을 들어오는 연결로 수락하기 위해 WskAccept 함수를 호출했습니다.
소켓을 들어오는 연결로 수락하기 위해 WskAcceptEvent 이벤트 콜백 함수가 호출되었습니다.

[in] IdealBacklogSize

새로운 이상적인 보내기 백로그 크기를 포함하는 변수입니다.

반환 값

WSK 애플리케이션의 WskSendBacklogEvent 이벤트 콜백 함수는 항상 STATUS_SUCCESS 반환해야 합니다.

설명

WSK 하위 시스템은 이벤트 콜백 함수가 이전에 SO_WSK_EVENT_CALLBACK 소켓 옵션을 사용하도록 설정한 경우에만 연결 지향 소켓에 대한 이상적인 송신 백로그 크기가 변경될 때 WSK 애플리케이션의 WskSendBacklogEvent 이벤트 콜백 함수를 호출합니다. 소켓의 이벤트 콜백 함수를 사용하도록 설정하는 방법에 대한 자세한 내용은 이벤트 콜백 함수 사용 및 비활성화를 참조하세요.

연결 지향 소켓에 대한 이상적인 송신 백로그 크기는 소켓의 데이터 스트림을 항상 가득 채울 수 있도록 미해결 상태로 유지해야 하는 최적의 전송 데이터 양(즉, WSK 하위 시스템에 전달되었지만 아직 완료되지 않음)입니다. WSK 애플리케이션은 이 크기를 사용하여 기본 연결의 흐름 제어 상태에 따라 전송할 데이터의 버퍼를 증분 방식으로 검색하고 잠글 수 있습니다.

WSK 애플리케이션은 WskControlSocket 함수를 호출하여 언제든지 연결 지향 소켓에 대한 현재 이상적인 백로그 크기를 가져올 수 있습니다.

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

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

요구 사항

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