SubmitIoRing 함수(ioringapi.h)

생성되었지만 아직 제출되지 않은 항목을 커널의 큐에 제출하고 필요에 따라 작업 집합이 완료될 때까지 기다립니다.

구문

HRESULT SubmitIoRing(
  HIORING ioRing,
  UINT32  waitOperations,
  UINT32  milliseconds,
  UINT32  *submittedEntries
);

ioRing

항목을 제출할 I/O 링에 대한 핸들을 나타내는 HIORING 입니다.

waitOperations

대기할 완료 큐 항목 수입니다. 0을 지정하면 호출이 대기해서는 안 됨을 나타냅니다. 이 값은 제출 큐의 항목 수와 현재 진행 중인 작업 수의 합계보다 작아야 합니다.

milliseconds

작업이 완료되기를 기다리는 시간(밀리초)입니다. 무기한 대기하도록 INFINITE 를 지정합니다. waitOperations에 대해 0을 지정하면 이 값은 무시됩니다.

submittedEntries

선택 사항입니다. 제출된 항목 수를 나타내는 UINT_32 값 배열에 대한 포인터를 받습니다.

다음 중 하나를 포함하지만 이에 국한되지 않는 HRESULT를 반환합니다.

값	설명
S_OK	큐의 모든 항목이 오류 없이 제출되었습니다.
IORING_E_WAIT_TIMEOUT	모든 작업이 오류 없이 제출되었고 이후 대기 시간이 초과되었습니다.
기타 오류 값	제출 큐 전체를 처리하지 못했습니다.

이 함수가 IORING_E_WAIT_TIMEOUT 이외의 오류를 반환하면 모든 항목이 제출 큐에 남아 있습니다. 단일 제출 큐 항목을 처리하는 동안 오류가 발생하면 완료 큐에 게시된 해당 항목이 동기적으로 완료되고 해당 작업에 대한 오류 상태 코드가 표시됩니다.