未燃のイメージ (現在の stash ファイル) の内容をクリアします。
構文
HRESULT ClearFormatContent();
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
注釈
stash ファイルは、メディアに記録する前にディスクをステージングするために使用される内部構造です。
SetActiveDiscRecorder は、アクティブ ドライブに IMAPI マルチセッション ディスクがあるかどうかを判断します。 その場合、IMAPI は自動的にマルチセッション モードに入ります。 複数セッション モードが確立された後 に ClearFormatContent を使用すると、IMAPI は単一セッション モードに戻ります。 これは、 RecordDisc の書き込みには空白のディスクが必要であることを意味します。
注意 このメソッドを呼び出すときは注意が必要です。 確認も回復もありません。 アプリケーションがイメージ ファイルにデータを入力し、このメソッドを呼び出すと、データは失われます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi.h |
| Library | Uuid.lib |
| [DLL] | Actxprxy.dll |