共用方式為


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