CloseIoRing 関数 (ioringapi.h)

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

構文

HRESULT CloseIoRing(
  HIORING ioRing
);

パラメーター

ioRing

閉じる HIORING ハンドル。

戻り値

成功したS_OKを返します。

注釈

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

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

Requirements