CreateIoRing 함수(ioringapi.h)

I/O 링 제출/완료 큐 쌍의 새 instance 만들고 IORING을 참조하기 위한 핸들을 반환합니다.

구문

HRESULT CreateIoRing(
  IORING_VERSION      ioringVersion,
  IORING_CREATE_FLAGS flags,
  UINT32              submissionQueueSize,
  UINT32              completionQueueSize,
  HIORING             *h
);

매개 변수

ioringVersion

링이 만들어지는 I/O 링 API의 버전을 나타내는 UNIT32입니다. 이 값은 QueryIoRingCapabilities 호출에서 검색된 값보다 작거나 같아야 합니다.

flags

생성 플래그를 지정하는 IORING_CREATE_FLAGS 열거형의 값입니다.

submissionQueueSize

요청된 최소 제출 큐 크기입니다. 시스템은 실제 크기가 2의 강력한지 확인하기 위해 필요에 따라 크기를 반올림할 수 있습니다. GetIoRingInfo를 호출하여 실제 할당된 큐 크기를 가져올 수 있습니다. QueryIoRingCapabilities를 호출하여 현재 시스템에서 최대 제출 큐 크기를 가져올 수 있습니다.

completionQueueSize

완료 큐의 요청된 최소 크기입니다. 시스템은 일부 작업이 아직 진행 중인 동안 제출을 허용하기 위해 실제 제출 큐 크기의 2배 이하인 2의 강력한 크기로 이 크기를 반올림합니다. GetIoRingInfo를 호출하여 실제 할당된 큐 크기를 가져올 수 있습니다.

h

만들기에 성공한 경우 결과 HIORING 핸들을 받습니다. 반환된 HIORING 링은 CloseHandle이 아닌 CloseIoRing을 호출하여 IORING에 대한 기본 리소스를 해제하여 닫혀야 합니다.

반환 값

다음을 포함하지만 이에 국한되지 않는 HRESULT:

값	설명
S_OK	성공.
IORING_E_UNKNOWN_VERSION	ioringVersion에 지정된 버전을 알 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Build 22000
지원되는 최소 서버	Windows Build 22000
머리글	ioringapi.h