CloseIoRing 関数 (ioringapi.h)

CreateIoRing の呼び出しで以前に開いた HIORING ハンドルを閉じます。

構文

HRESULT CloseIoRing(
  HIORING ioRing
);

パラメーター

ioRing

閉じる HIORING ハンドル。

戻り値

成功すると S_OK を返します。

解説

この関数を呼び出すと、I/O リングに割り当てられたリソースが解放されます。 閉じたハンドルは、関数が戻った後に無効になります。 ハンドルを閉じると、キューに入っているが送信されない操作は破棄されることに注意してください。 ただし、飛行中の操作は取り消 されません 。

CloseIoRing から戻った後も、メモリ バッファーからの読み取りまたはメモリ バッファーへの書き込みが発生する可能性があります。 保留中の読み取りまたは書き込みが行われないようにするには、送信されたすべての操作の完了が完了キューに表示されるのを待つ必要があります。 完了を待つ前に、前に送信した操作をキャンセルすることもできます。 複数のキャンセル要求を送信する代わりに、ファイル ハンドルと NULL ポインターを使用して CancelIoEx を呼び出して、ハンドルに対するすべての保留中の操作を効果的に取り消すことができます。

要件

サポートされている最小のクライアント	Windows ビルド 22000
サポートされている最小のサーバー	Windows ビルド 22000
ヘッダー	ioringapi.h