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以外のエラーを返した場合、すべてのエントリは送信キューに残ります。 1 つの送信キューエントリを処理するエラーが発生すると、そのエントリが完了キューにポストされ、その操作のエラー状態コードが同期的に完了します。