SIO_IDEAL_SEND_BACKLOG_CHANGE 제어 코드

아티클
10/11/2023

설명

SIO_IDEAL_SEND_BACKLOG_CHANGE 제어 코드는 연결에 대한 ISB(이상적인 보내기 백로그) 값이 변경되면 애플리케이션에 알릴 수 있습니다.

이 작업을 수행하려면 다음 매개 변수를 사용하여 WSAIoctl 또는 WSPIoctl 함수를 호출합니다.

int WSAIoctl(
  (socket) s,             // descriptor identifying a socket
  SIO_IDEAL_SEND_BACKLOG_CHANGE, // dwIoControlCode
  NULL,                         // lpvInBuffer
  0,                            // cbInBuffer
  NULL,         // output buffer
  0,       // size of output buffer
  (LPDWORD) lpcbBytesReturned,    // number of bytes returned
  (LPWSAOVERLAPPED) lpOverlapped,   // OVERLAPPED structure
  (LPWSAOVERLAPPED_COMPLETION_ROUTINE) lpCompletionRoutine,  // completion routine
);

int WSPIoctl(
  (socket) s,             // descriptor identifying a socket
  SIO_IDEAL_SEND_BACKLOG_CHANGE, // dwIoControlCode
  NULL,                         // lpvInBuffer
  0,                            // cbInBuffer
  NULL,         // output buffer
  0,       // size of output buffer
  (LPDWORD) lpcbBytesReturned,    // number of bytes returned
  (LPWSAOVERLAPPED) lpOverlapped,   // OVERLAPPED structure
  (LPWSAOVERLAPPED_COMPLETION_ROUTINE) lpCompletionRoutine,  // completion routine
  (LPWSATHREADID) lpThreadId,   // a WSATHREADID structure
  (LPINT) lpErrno   // a pointer to the error code.
);

매개 변수

s

소켓을 식별하는 설명자입니다.

dwIoControlCode

작업을 위한 제어 코드입니다. 이 작업에는 SIO_IDEAL_SEND_BACKLOG_CHANGE 사용합니다.

lpvInBuffer

입력 버퍼에 대한 포인터입니다. 이 매개 변수는 이 작업에 사용되지 않습니다.

cbInBuffer

입력 버퍼의 크기(바이트)입니다. 이 매개 변수는 이 작업에 사용되지 않습니다.

lpvOutBuffer

출력 버퍼에 대한 포인터입니다. 이 매개 변수는 이 작업에 사용되지 않습니다.

cbOutBuffer

출력 버퍼의 크기(바이트)입니다. 이 매개 변수는 0으로 설정해야 합니다.

lpcbBytesReturned

출력 버퍼에 저장된 데이터의 크기(바이트)를 수신하는 변수에 대한 포인터입니다. 이 반환된 매개 변수는 출력이 없으므로 이 작업에 대한 DWORD 값 0을 가리킵니다.

lpvOverlapped

WSAOVERLAPPED 구조체에 대한 포인터입니다.

겹치는 특성 없이 소켓 을 만든 경우 lpOverlapped 매개 변수는 무시됩니다.

겹치는 특성으로 연 경우 lpOverlapped 매개 변수가 NULL이 아니면 작업이 겹치는(비동기) 작업으로 수행됩니다. 이 경우 lpOverlapped 매개 변수는 유효한 WSAOVERLAPPED 구조를 가리킵니다.

겹치는 작업의 경우 WSAIoctl 또는 WSPIoctl 함수는 즉시 반환되고 작업이 완료되면 적절한 완료 메서드가 신호로 전송됩니다. 그렇지 않으면 작업이 완료되거나 오류가 발생할 때까지 함수가 반환되지 않습니다.

lpCompletionRoutine

형식: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

작업이 완료되었을 때 호출되는 완료 루틴에 대한 포인터입니다(겹치지 않는 소켓의 경우 무시됨).

lpThreadId

WPUQueueApc에 대한 후속 호출에서 공급자가 사용할 WSATHREADID 구조체에 대한 포인터입니다. 공급자는 WPUQueueApc 함수가 반환될 때까지 참조된 WSATHREADID 구조체(동일한 포인터가 아님)를 저장해야 합니다.

참고 이 매개 변수는 WSPIoctl 함수에만 적용됩니다.

lpErrno

오류 코드에 대한 포인터입니다.

참고 이 매개 변수는 WSPIoctl 함수에만 적용됩니다.

반환 값

작업이 성공적으로 완료되면 WSAIoctl 또는 WSPIoctl 함수는 0을 반환합니다.

작업이 실패하거나 보류 중인 경우 WSAIoctl 또는 WSPIoctl 함수는 SOCKET_ERROR 반환합니다. 확장 오류 정보를 얻으려면 WSAGetLastError를 호출합니다.

오류 코드	의미
WSA_IO_PENDING	겹치는 작업이 성공적으로 시작되었으며 나중에 완료가 표시됩니다.
WSA_OPERATION_ABORTED	소켓의 닫기 또는 SIO_FLUSH IOCTL 명령의 실행으로 인해 겹치는 작업이 취소되었습니다.
WSAEFAULT	lpOverlapped 또는 lpCompletionRoutine 매개 변수는 사용자 주소 공간의 유효한 부분에 완전히 포함되지 않습니다.
WSAEINPROGRESS	콜백이 진행 중일 때 함수가 호출됩니다.
WSAEINTR	차단 작업이 중단되었습니다.
WSAEINVAL	dwIoControlCode 매개 변수가 유효한 명령이 아니거나 지정된 입력 매개 변수가 허용되지 않거나 지정된 소켓 유형에 명령을 적용할 수 없습니다. cbOutBuffer 매개 변수가 0이 아닌 경우 이 오류가 반환됩니다.
WSAENETDOWN	네트워크 하위 시스템이 실패했습니다.
WSAENOPROTOOPT	소켓 옵션은 지정된 프로토콜에서 지원되지 않습니다.
WSAENOTCONN	소켓 이 연결되지 않았습니다.
WSAENOTSOCK	설명자가 소켓이 아닙니다.
WSAEOPNOTSUPP	지정된 IOCTL 명령은 지원되지 않습니다. 이 오류는 SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL이 전송 공급자에서 지원되지 않는 경우 반환됩니다. 이 오류는 데이터그램 소켓에서 SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL을 사용하려고 할 때도 반환됩니다.

설명

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 Windows Server 2008, Windows Vista sp1(서비스 팩 1) 및 이후 버전의 운영 체제에서 지원됩니다.

Windows 소켓을 사용하여 TCP 연결을 통해 데이터를 전송할 때는 처리량이 가장 높도록 TCP에서 충분한 양의 데이터를 미해결 상태로 유지하는 것이 중요합니다(전송되었지만 아직 승인되지 않음). TCP 연결에 대한 최상의 처리량을 달성하기 위해 미해결 데이터 양에 이상적인 값을 ISB(이상적인 송신 백로그) 크기라고 합니다. ISB 값은 TCP 연결 및 수신자의 보급 수신 기간(그리고 부분적으로 네트워크의 정체 양)의 대역폭 지연 곱의 함수입니다.

연결당 ISB 값은 Windows Server 2008의 TCP 프로토콜 구현, WINDOWS Vista SP1 이상 버전의 운영 체제에서 사용할 수 있습니다. SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 연결에 대해 ISB 값이 동적으로 변경될 때 애플리케이션에서 알림을 받는 데 사용할 수 있습니다.

Windows Server 2008, WINDOWS Vista SP1 이상 버전의 운영 체제에서는 연결된 상태의 스트림 지향 소켓에서 SIO_IDEAL_SEND_BACKLOG_CHANGE 및 SIO_IDEAL_SEND_BACKLOG_QUERY IOCTL이 지원됩니다.

TCP 연결의 ISB 값 범위는 이론적으로 0에서 최대 16MB까지 다양할 수 있습니다.

높은 대역폭 지연 제품 연결을 통해 더 나은 처리량을 달성하기 위한 ISB 메커니즘의 일반적인 사용은 SIO_IDEAL_SEND_BACKLOG_QUERY IOCTL 참조 페이지를 참조하세요.

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 연결된 상태의 스트림 소켓에서만 허용됩니다. 그렇지 않으면 WSAENOTCONN으로 WSAIoctl 또는 WSPIoctl 함수가 실패합니다.

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 입력 또는 출력 버퍼를 사용하지 않으며 기본 연결에서 ISB 변경이 발생할 때까지 보류되거나 차단됩니다. 이 IOCTL이 완료되면 Winsock 애플리케이션은 SIO_IDEAL_SEND_BACKLOG_QUERY IOCTL을 사용하여 연결에서 새 ISB 값을 검색할 수 있습니다.

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 비차단 모드를 지원하지 않습니다. 애플리케이션은 비차단 소켓에서 이 IOCTL을 발급할 수 있지만, IOCTL은 ISB 값이 변경될 때까지 단순히 차단하거나 보류합니다.

lpOverlapped 및 lpCompletionRoutine 매개 변수가 모두 NULL인 경우 이 함수의 소켓은 겹치지 않는 소켓으로 처리됩니다. 겹치지 않는 소켓 의 경우 lpOverlapped 및 lpCompletionRoutine 매개 변수는 무시됩니다. 단, 소켓 이 차단 모드인 경우 함수가 차단할 수 있습니다. 소켓 이 비차단 모드인 경우 이 특정 IOCTL은 비차단 모드를 지원하지 않으므로 이 함수는 여전히 차단됩니다.

겹치는 소켓의 경우 즉시 완료할 수 없는 작업이 시작되고 나중에 완료가 표시됩니다.

모든 IOCTL은 서비스 공급자의 구현에 따라 무기한 차단할 수 있습니다. 애플리케이션이 WSAIoctl 또는 WSPIoctl 함수 호출에서 차단을 허용할 수 없는 경우 특히 차단할 가능성이 있는 IOCTL에 대해 겹치는 I/O를 권장합니다.

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 알림을 제공하며 ISB 값이 변경될 때까지 차단하거나 보류해야 합니다. 따라서 일반적으로 lpOverlapped 매개 변수가 유효한 WSAOVERLAPPED 구조체로 설정된 상태에서 비동기적으로 호출됩니다.

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL은 다음과 같은 경우에 WSAEINTR 또는 WSA_OPERATION_ABORTED 실패할 수 있습니다.

TCP 연결이 송신 방향에서 정상적으로 연결이 끊어졌습니다. 이는 매개 변수가 SD_SEND 설정되는 방법, DisconnectEx 함수에 대한 호출 또는 dwFlags 매개 변수가 TF_DISCONNECT 또는 TF_REUSE 설정된 TransmitFile 또는 TransmitPackets 함수에 대한 호출을 사용하여 종료 함수를 호출한 결과로 발생할 수 있습니다.
TCP 연결이 다시 설정되거나 중단되었습니다.
애플리케이션은 이미 보류 중인 알림 요청이 있는 경우 SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL을 발급합니다. 한 번에 하나의 보류된 SIO_IDEAL_SEND_BACKLOG_CHANGE 요청만 허용됩니다.
I/O 관리자가 요청을 취소합니다.
소켓이 닫혔습니다.

이러한 IOCTL에 대한 두 개의 인라인 래퍼 함수는 Ws2tcpip.h 헤더 파일에 정의됩니다. 이러한 인라인 함수는 SIO_IDEAL_SEND_BACKLOG_CHANGE 사용하고 IOCTL을 직접 SIO_IDEAL_SEND_BACKLOG_QUERY 대신 사용하는 것이 좋습니다.

SIO_IDEAL_SEND_BACKLOG_CHANGE IOCTL의 인라인 래퍼 함수는 idealsendbacklognotify 함수입니다.

SIO_IDEAL_SEND_BACKLOG_QUERY IOCTL에 대한 인라인 래퍼 함수는 idealsendbacklogquery 함수입니다.