RIORESULT 구조체(mswsockdef.h)

아티클
08/25/2023

RIORESULT 구조에는 Winsock 등록 I/O 확장과 함께 사용되는 요청 완료 결과를 나타내는 데 사용되는 데이터가 포함되어 있습니다.

구문

typedef struct _RIORESULT {
  LONG      Status;
  ULONG     BytesTransferred;
  ULONGLONG SocketContext;
  ULONGLONG RequestContext;
} RIORESULT, *PRIORESULT;

멤버

Status

Winsock 등록 I/O 요청의 완료 상태.

BytesTransferred

I/O 요청에서 보내거나 받은 바이트 수입니다.

SocketContext

RIOCreateRequestQueue 함수 호출에 지정된 애플리케이션 제공 컨텍스트입니다.

RequestContext

RIOReceive, RIOReceiveEx, RIOSend 및 RIOSendEx 함수에 등록된 I/O 요청으로 지정된 애플리케이션 제공 컨텍스트입니다.

설명

RIORESULT 구조는 Winsock 등록 I/O 확장의 요청 완료를 나타내는 데 사용되는 데이터 형식을 정의합니다. 애플리케이션은 RIORESULT 구조체 배열을 할당하고 RIORESULT 구조체의 배열을 요소 수와 함께 RIODequeueCompletion 함수에 전달하여 완료 표시를 요청합니다. 애플리케이션은 RIODequeueCompletion 함수를 호출하기 전에 RIORESULT 구조 요소의 초기화를 수행할 필요가 없습니다.

RIORESULT 구조체의 SocketContext 멤버를 애플리케이션에서 사용하여 winsock 등록 I/O 요청이 발생한 RIO_CQ 개체 또는 연결된 애플리케이션 개체를 식별할 수 있습니다. RIORESULT 구조의 RequestContext 멤버를 마찬가지로 사용하여 완료된 특정 Winsock 등록 I/O 요청을 식별할 수 있습니다.

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

요구 사항

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