SubmitIoRing 函式 (ioringapi.h)
將所有建構但尚未提交的專案提交至核心的佇列,並選擇性地等候一組作業完成。
語法
HRESULT SubmitIoRing(
HIORING ioRing,
UINT32 waitOperations,
UINT32 milliseconds,
UINT32 *submittedEntries
);
參數
ioRing
HIORING,代表將提交專案的 I/O 通道句柄。
waitOperations
要等候的完成佇列項目數目。 指定 0 表示呼叫不應該等候。 此值必須小於提交佇列中項目數目的總和,以及目前正在執行的作業數目。
milliseconds
等候作業完成的毫秒數。 指定 INFINITE 以無限期等候。 如果為 waitOperations 指定 0,則會忽略此值。
submittedEntries
選擇性。 接收代表所提交項目數之 UINT_32 值的陣列指標。
傳回值
傳回 HRESULT,包括但不限於下列其中一項:
值 | 描述 |
---|---|
S_OK | 佇列中的所有專案都已提交,而不會發生錯誤。 |
IORING_E_WAIT_TIMEOUT | 所有作業都會提交,而不會發生錯誤,而後續的等候逾時。 |
任何其他錯誤值 | 無法完全處理提交佇列。 |
備註
如果此函式傳回IORING_E_WAIT_TIMEOUT以外的錯誤,則所有項目都會保留在提交佇列中。 處理單一提交佇列專案的任何錯誤,都會導致該專案張貼至完成佇列的同步完成,並顯示該作業的錯誤狀態代碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 組建 22000 |
最低支援的伺服器 | Windows 組建 22000 |
標頭 | ioringapi.h |