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，包括但不限於下列其中一項：

備註

如果此函式傳回IORING_E_WAIT_TIMEOUT以外的錯誤，則所有項目都會保留在提交佇列中。 處理單一提交佇列項目的任何錯誤都會導致該項目同步完成張貼至完成佇列，並顯示該作業的錯誤狀態碼。

需求