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 이외의 오류를 반환하면 모든 항목이 제출 큐에 남아 있습니다. 단일 제출 큐 항목을 처리하는 동안 오류가 발생하면 완료 큐에 게시된 해당 항목이 동기적으로 완료되고 해당 작업에 대한 오류 상태 코드가 표시됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Build 22000 |
지원되는 최소 서버 | Windows Build 22000 |
머리글 | ioringapi.h |