IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)

  • [アーティクル]

ドライバーは、消去プロセスをストレージ デバイスにオフロードする IOCTL_STORAGE_REINITIALIZE_MEDIA コントロール コードを発行できます。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

Windows Server 2022 以降の場合、 には、サニタイズ オプションを含むオプション のSTORAGE_REINITIALIZE_MEDIA 構造体 (NULL) が含まれています。 以前の OS バージョンの場合、入力バッファーは NULL です。

入力バッファーの長さ

リリース 21H1 以降Windows 10、Parameters.DeviceIoControl.InputBufferLength は Irp-AssociatedIrp.SystemBuffer> のパラメーター バッファーのサイズ (バイト単位) を示します。Parameters.DeviceIoControl.InputBuffer != NULL の場合は sizeof(STORAGE_REINITIALIZE_MEDIA) にする必要があります>。それ以外の場合は 0 です。 以前の OS バージョンの場合、入力バッファーの長さは 0 です。

出力バッファー

[なし] :

出力バッファーの長さ

[なし] :

入力/出力バッファー

該当なし

入力/出力バッファーの長さ

該当なし

ステータス ブロック

呼び出しが正常に完了した場合、 Information フィールドは 0 に設定されます。それ以外の場合は、0 以外の値に設定されます。

注釈

IOCTL_STORAGE_REINITIALIZE_MEDIA は、消去をストレージ デバイスにオフロードします。 コマンドの完了後にストレージ デバイスのデータが正常に削除または回復できる保証はありません。

この IOCTL は、デスクトップ デバイス ファミリ内のデバイス上のデータ ディスクに制限されます。 Windows プレインストール環境 (WinPE) では、この IOCTL はブート ディスクとデータ ディスクの両方でサポートされています。

以前の OS バージョンでは、実装では入力は必要なく、状態以外の出力は返されません。

呼び出し元は、この IOCTL を呼び出す前に、最初に FSCTL_LOCK_VOLUME を呼び出して、上位レイヤーにキャッシュされたデータをフラッシュする必要があります。 未処理の要求完了の待機は、デバイスにコマンドを発行する前に行われません。

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1607
サポートされている最小のサーバー Windows Server 2016
Header ntddstor.h

こちらもご覧ください

IO_STATUS_BLOCK構造体

STORAGE_REINITIALIZE_MEDIA

ディスパッチ ルーチン内で IRP を完了する方法