RIO_BUF 구조체(mswsockdef.h)

아티클
02/29/2024

RIO_BUF 구조체는 Winsock 등록 I/O 확장을 사용하여 네트워크 데이터를 보내거나 받는 데 사용되는 등록된 버퍼의 일부를 지정합니다.

구문

typedef struct _RIO_BUF {
  RIO_BUFFERID BufferId;
  ULONG        Offset;
  ULONG        Length;
} RIO_BUF, *PRIO_BUF;

멤버

BufferId

송신 및 수신 요청에 사용되는 Winsock 등록 I/O 버퍼에 대해 등록된 버퍼 설명자입니다.

Offset

BufferId 멤버가 지정한 버퍼에 대한 오프셋(바이트)입니다. 오프셋 값 0은 버퍼의 시작을 가리킵니다.

Length

Offset 멤버에서 사용할 버퍼의 길이(바이트)입니다.

설명

Winsock에 등록된 I/O 확장은 종종 버퍼 조각이라고도 하는 등록된 버퍼의 일부에서 작동합니다. RIO_BUF 구조는 네트워크 데이터를 보내거나 받기 위해 소량의 등록된 메모리를 사용해야 하는 애플리케이션에서 사용됩니다. 애플리케이션은 종종 하나의 큰 버퍼를 등록한 다음 필요에 따라 버퍼의 작은 청크를 사용하여 성능을 높일 수 있습니다. RIO_BUF 구조는 단일 버퍼 등록에 포함된 메모리의 연속 세그먼트를 설명할 수 있습니다.

RIO_BUF 구조체에 대한 포인터는 pData 매개 변수로 RIOSend, RIOSendEx, RIOReceive 및 RIOReceiveEx 함수에 전달 되어 네트워크 데이터를 보내거나 받습니다.

애플리케이션은 단순히 RIORegisterBuffer 함수를 사용하여 등록된 원래 버퍼보다 큰 값이 있는 버퍼 조각을 사용하여 등록된 버퍼의 크기를 조정할 수 없습니다.

RIO_BUF 구조체는 Mswsock.h 헤더 파일에 자동으로 포함되는 Mswsockdef.h 헤더 파일에 정의됩니다. Mswsockdef.h 헤더 파일은 직접 사용하면 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
머리글	mswsockdef.h(Mswsock.h 포함)