次の方法で共有

CreateIoRing 関数 (ioringapi.h)

  • [アーティクル]

I/O リング送信/完了キュー ペアの新しいインスタンスを作成し、IORING を参照するためのハンドルを返します。

構文

HRESULT CreateIoRing(
  IORING_VERSION      ioringVersion,
  IORING_CREATE_FLAGS flags,
  UINT32              submissionQueueSize,
  UINT32              completionQueueSize,
  HIORING             *h
);

パラメーター

ioringVersion

リングが作成される I/O リング API のバージョンを表す UNIT32。 この値は、QueryIoRingCapabilities の呼び出しから取得された値以下である必要があります

flags

作成フラグを指定する IORING_CREATE_FLAGS 列挙からの値。

submissionQueueSize

要求された最小送信キュー サイズ。 システムは、必要に応じてサイズを切り上げて、実際のサイズが 2 の累乗であることを確認できます。 GetIoRingInfo を呼び出すことで、実際に割り当てられたキュー サイズを取得できます。 QueryIoRingCapabilities を呼び出すことで、現在のシステムで送信キューの最大サイズを取得できます。

completionQueueSize

入力候補キューの要求された最小サイズ。 システムは、このサイズを実際の送信キュー サイズの 2 倍以下の 2 乗に切り上げて、一部の操作がまだ進行中の間に送信できるようにします。 GetIoRingInfo を呼び出すことで、実際に割り当てられたキュー サイズを取得できます。

h

作成が成功した場合は、結果の HIORING ハンドルを 受け取ります。 返された HIORING リングは、IORING の基になるリソースを解放するために、CloseHandle ではなく CloseIoRing を呼び出して閉じる必要があります。

戻り値

HRESULT。以下を含みますが、これらに限定されません。

値 説明
S_OK 正常終了しました。
IORING_E_UNKNOWN_VERSION ioringVersion で指定されたバージョンが不明です。

要件

要件 値
サポートされている最小のクライアント Windows ビルド 22000
サポートされている最小のサーバー Windows ビルド 22000
Header ioringapi.h