IDiscFormat2Data

Buffer Underrun Free 記録を無効にする場合は VARIANT_TRUE を、それ以外の場合は VARIANT_FALSE を設定します。既定値は VARIANT_FALSE (有効) です。

戻り値

戻り値	説明
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	現在、書き込み操作が実行中です。値: 0xC0AA0400

解説(Remarks)

デバイスが連続して書き込みを続けられるだけの速さでデータストリームがバッファーに入らない場合、バッファーアンダーランが問題になることがあります。その結果、書き込みの停止と再開によってディスク上のデータが使用できなくなる可能性があります。Buffer Underrun Free (BUF) 記録では、ディスクに既に書き込まれたデータを破損させることなくレーザーを停止および再開できます。BUF 記録を無効にできるのは CD-R/RW メディアのみです。

vtbl 15 HRESULT get_BufferUnderrunFreeDisabled(VARIANT_BOOL* value)

CD-R、CD-RW、DVD-R の各メディアで Buffer Underrun Free 記録が有効かどうかを示します。

value

out

Buffer Underrun Free 記録が無効の場合は VARIANT_TRUE、それ以外の場合は VARIANT_FALSE (有効) です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 16 HRESULT put_PostgapAlreadyInImage(VARIANT_BOOL value)

データストリームにポストギャップが含まれるかどうかを指定します。(Put)

value

データストリームにポストギャップが含まれる場合は VARIANT_TRUE を、それ以外の場合は VARIANT_FALSE を設定します。既定値は VARIANT_FALSE です。

戻り値

戻り値	説明
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	現在、書き込み操作が実行中です。値: 0xC0AA0400

解説(Remarks)

CD-R/RW メディアへの書き込みでは、このプロパティを明示的に無効にしない限り、150 セクターのポストギャップが自動的に追加されることに注意してください。

vtbl 17 HRESULT get_PostgapAlreadyInImage(VARIANT_BOOL* value)

データストリームにポストギャップが含まれるかどうかを示します。(Get)

value

IMAPI_FORMAT2_DATA_MEDIA_STATE*

out

データストリームにポストギャップが含まれる場合は VARIANT_TRUE、それ以外の場合は VARIANT_FALSE です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 18 HRESULT get_CurrentMediaStatus(IMAPI_FORMAT2_DATA_MEDIA_STATE* value)

デバイス内のメディアの現在の状態を取得します。

value

out

ディスクデバイス内のメディアの状態です。指定できる値については、IMAPI_FORMAT2_DATA_MEDIA_STATE 列挙型を参照してください。複数の状態が設定される場合があることに注意してください。

戻り値

戻り値	説明
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210

解説(Remarks)

このプロパティを使用する例については、「Checking Media Support」を参照してください。

vtbl 19 HRESULT get_WriteProtectStatus(IMAPI_MEDIA_WRITE_PROTECT_STATE* value)

デバイス内のメディアの現在の書き込み禁止状態を取得します。

value

IMAPI_MEDIA_WRITE_PROTECT_STATE*

out

デバイス内のメディアの現在の書き込み禁止状態です。指定できる値については、IMAPI_MEDIA_WRITE_PROTECT_STATE 列挙型を参照してください。

複数の状態が設定される場合があることに注意してください。

戻り値

戻り値	説明
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210

vtbl 20 HRESULT get_TotalSectorsOnMedia(INT* value)

デバイス内のメディアのセクター数を取得します。

value

out

デバイス内のメディアのセクター数です。この数には、空きセクター、使用済みセクター、およびブートセクターが含まれます。

戻り値

戻り値	説明
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE	要求された操作は、サポートされているメディアでのみ有効です。値: 0xC0AA0402

解説(Remarks)

この値は、空のディスクの場合であっても、メディア上で使用可能なセクターの総数を必ずしも表すものではありません。

vtbl 21 HRESULT get_FreeSectorsOnMedia(INT* value)

追記 (既存データを上書きしない記録) に使用できる、ディスク上の空きセクター数を取得します。

value

out

デバイス内のメディアの空きセクター数です。

戻り値

戻り値	説明
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE	要求された操作は、サポートされているメディアでのみ有効です。値: 0xC0AA0402

解説(Remarks)

このプロパティの値は、実質的に書き込み操作で使用できるディスク上のセクター数です。ランアウトブロックやポストギャップなど、ディスク領域の管理やデータ品質の確保のために消費されるセクターは除外されます。

注意物理セッションを 1 つしか持たない上書き可能なディスクでは、value が示す空きセクター数は常にディスク上のセクターの総数になります。

IDiscFormat2Data::put_ForceOverwrite に VARIANT_TRUE が設定されている場合は、代わりに IDiscFormat2Data::get_TotalSectorsOnMedia プロパティを使用してください。

vtbl 22 HRESULT get_NextWritableAddress(INT* value)

次の書き込み操作の位置を取得します。

value

out

次の書き込み操作が開始されるアドレスです。

戻り値

戻り値	説明
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE	要求された操作は、サポートされているメディアでのみ有効です。値: 0xC0AA0402

解説(Remarks)

空のメディアでは、書き込みは位置 0 から開始されます。

マルチセッション書き込みでは、次に書き込み可能なアドレスは正しいファイルシステムを構成する際に役立ちます。

vtbl 23 HRESULT get_StartAddressOfPreviousSession(INT* value)

前回の書き込みセッションの先頭セクターを取得します。

value

out

前回の書き込み操作が開始されたアドレスです。

メディアが空の場合、またはマルチセッション書き込みをサポートしていない場合、値は -1 になります (前のセッションを検出できなかったことを示します)。

戻り値

戻り値	説明
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE	要求された操作は、サポートされているメディアでのみ有効です。値: 0xC0AA0402

解説(Remarks)

注意このプロパティは使用しないでください。前のセッションからファイルデータをインポートするには、代わりに IMultisessionSequential などの IMultisession から派生したインターフェイスを使用してください。

vtbl 24 HRESULT get_LastWrittenAddressOfPreviousSession(INT* value)

前回の書き込みセッションの最終セクターを取得します。

value

out

前回の書き込み操作が終了したアドレスです。

戻り値

戻り値	説明
E_NOTIMPL	実装されていません。値: 0x80004001

解説(Remarks)

vtbl 25 HRESULT put_ForceMediaToBeClosed(VARIANT_BOOL value)

ファイルシステムへのそれ以上の追加を禁止するかどうかを指定します。(Put)

value

次の書き込みセッションの終了時にディスクをクローズ済みとしてマークし、追加の書き込みを禁止する場合は VARIANT_TRUE を設定します。

以降の書き込みセッションのためにディスクをオープンのままにする場合は VARIANT_FALSE を設定します。既定値は VARIANT_FALSE です。

戻り値

戻り値	説明
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	現在、書き込み操作が実行中です。値: 0xC0AA0400

解説(Remarks)

ディスクの空き領域が 2% 以下になると、このプロパティの値に関係なく、書き込み処理はディスクをクローズ済みとしてマークします。これは、書き込みセッションでファイルシステムを記録するための十分な空き領域をディスクに確保するための動作です。

クローズ済みとしてマークされた書き換え可能ディスクは消去できます。

IDiscFormat2Data::put_DisableConsumerDvdCompatibilityMode プロパティがこのプロパティより優先される場合があることに注意してください。詳細については put_DisableConsumerDvdCompatibilityMode を参照してください。

vtbl 26 HRESULT get_ForceMediaToBeClosed(VARIANT_BOOL* value)

ファイルシステムへのそれ以上の追加が禁止されているかどうかを示します。(Get)

value

out

次の書き込みセッションの終了時にディスクをクローズ済みとしてマークし、以降の書き込みセッションを禁止する場合は VARIANT_TRUE です。以降の書き込みセッションのためにディスクをオープンのままにする場合は VARIANT_FALSE です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 27 HRESULT put_DisableConsumerDvdCompatibilityMode(VARIANT_BOOL value)

DVD の記録セッションに、デバイスが DVD を再生できる可能性を高める処理を含めるかどうかを指定します。(Put)

value

より多くの民生機器でディスクを再生できるようにするための処理を省略する場合は VARIANT_TRUE を設定します。互換性のための処理を省くと、記録セッションの所要時間が短縮され、ディスク上に必要な空き領域も少なくなります。

デバイスが DVD を再生できる可能性を高める場合は VARIANT_FALSE を設定します。既定値は VARIANT_FALSE です。

戻り値

戻り値	説明
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	現在、書き込み操作が実行中です。値: 0xC0AA0400

解説(Remarks)

このプロパティは、CD メディアおよび DVD ダッシュ (DVD-) メディアには影響しません。

DVD+R および DVD+DL メディアでは、このプロパティはメディアのクローズ操作にも影響します。

DisableConsumerDvdCompatibilityMode の値	ForceMediaToBeClosed の値	クローズ操作
False	True	互換モードでディスクをクローズします
False	False	互換モードでディスクをクローズします
True	True	通常どおりディスクをクローズします
True	False	DVD+R ではセッションをクローズし、DVD+R DL では通常どおりディスクをクローズします

vtbl 28 HRESULT get_DisableConsumerDvdCompatibilityMode(VARIANT_BOOL* value)

DVD の記録セッションに、デバイスが DVD を再生できる可能性を高める処理が含まれるかどうかを示します。(Get)

value

IMAPI_MEDIA_PHYSICAL_TYPE*

out

より多くの民生機器でディスクを再生できるようにするための処理をセッションが省略する場合は VARIANT_TRUE です。

民生機器との読み取り互換性を最大化するようにメディアへ書き込む場合は VARIANT_FALSE です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

このプロパティは、CD メディアには影響しません。

vtbl 29 HRESULT get_CurrentPhysicalMediaType(IMAPI_MEDIA_PHYSICAL_TYPE* value)

ディスクデバイス内のメディアの種類を取得します。(IDiscFormat2Data.get_CurrentPhysicalMediaType)

value

out

ディスクデバイス内のメディアの種類です。指定できる値については、IMAPI_MEDIA_PHYSICAL_TYPE 列挙型を参照してください。

戻り値

戻り値	説明
E_IMAPI_RECORDER_REQUIRED	この要求には、現在のディスクレコーダーが選択されている必要があります。値: 0xC0AA0003
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。注意この値は NULL ポインターを示すものではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210

vtbl 30 HRESULT put_ClientName(LPWSTR value)

クライアントのフレンドリ名を設定します。(IDiscFormat2Data.put_ClientName)

value

LPWSTR

クライアントアプリケーションの名前です。NULL や空の文字列は指定できません。

戻り値

戻り値	説明
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_DF2DATA_CLIENT_NAME_IS_NOT_VALID	クライアント名が有効ではありません。値: 0xC0AA0211
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	現在、書き込み操作が実行中です。値: 0xC0AA0500

解説(Remarks)

この名前は、書き込み操作がデバイスへの排他アクセスを要求する際に使用されます。IDiscRecorder2::get_ExclusiveAccessOwner プロパティには、ロックを保持しているクライアントの名前が格納されます。

書き込み操作中に CDROM デバイスへの読み取り/書き込みアクセス権を持つアプリケーションであれば、IOCTL_CDROM_EXCLUSIVE_ACCESS (クエリ) 制御コード (Microsoft Windows Driver Development Kit (DDK) を参照) を使用してこの名前を参照できます。そのため、この名前は、このインターフェイスを使用してメディアに書き込んでいるプログラムを識別できるものにすることが重要です。名前に使用できる文字は、IOCTL_CDROM_EXCLUSIVE_ACCESS 制御コードが要求する文字セットに制限されます。

vtbl 31 HRESULT get_ClientName(LPWSTR* value)

クライアントのフレンドリ名を取得します。(IDiscFormat2Data.get_ClientName)

value

LPWSTR*

out

クライアントアプリケーションの名前です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E

vtbl 32 HRESULT get_RequestedWriteSpeed(INT* value)

要求された書き込み速度を取得します。(IDiscFormat2Data.get_RequestedWriteSpeed)

value

out

1 秒あたりのディスクセクター数で表した、要求された書き込み速度です。

0xFFFFFFFF (-1) は、そのメディアでサポートされる最速の速度で書き込みを行うことを要求します。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

これは、直近の IDiscFormat2Data::SetWriteSpeed メソッドの呼び出しで指定された値です。

vtbl 33 HRESULT get_RequestedRotationTypeIsPureCAV(VARIANT_BOOL* value)

要求された回転速度制御の種類を取得します。(IDiscFormat2Data.get_RequestedRotationTypeIsPureCAV)

value

out

要求された回転速度制御の種類です。角速度一定 (CAV) の回転速度制御の場合は VARIANT_TRUE です。レコーダーがサポートするその他の回転速度制御の場合は VARIANT_FALSE です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

解説(Remarks)

これは、直近の IDiscFormat2Data::SetWriteSpeed メソッドの呼び出しで指定された値です。

vtbl 34 HRESULT get_CurrentWriteSpeed(INT* value)

ドライブの現在の書き込み速度を取得します。(IDiscFormat2Data.get_CurrentWriteSpeed)

value

out

1 秒あたりのセクター数で表した、現在のメディアの書き込み速度です。

戻り値

戻り値	説明
E_IMAPI_RECORDER_REQUIRED	この要求には、現在のディスクレコーダーが選択されている必要があります。値: 0xC0AA0003
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE	ドライブが回復不能なエラー情報を返したため、書き込みに失敗しました。値: 0xC0AA0301

解説(Remarks)

要求された書き込み速度を取得するには、IDiscFormat2Data::get_RequestedWriteSpeed メソッドを呼び出します。

レコーダーと現在のメディアがサポートする書き込み速度の一覧を取得するには、IDiscFormat2Data::get_SupportedWriteSpeeds メソッドを呼び出します。

書き込み速度はメディアの書き込み速度に基づいていることに注意してください。このプロパティの値は、メディアが交換されると変化することがあります。

vtbl 35 HRESULT get_CurrentRotationTypeIsPureCAV(VARIANT_BOOL* value)

レコーダーが使用している現在の回転速度制御を取得します。(IDiscFormat2Data.get_CurrentRotationTypeIsPureCAV)

value

out

角速度一定 (CAV) の回転速度制御が使用されている場合は VARIANT_TRUE です。それ以外の場合は VARIANT_FALSE で、レコーダーがサポートする別の回転速度制御が使用されていることを示します。

戻り値

戻り値	説明
E_IMAPI_RECORDER_REQUIRED	この要求には、現在のディスクレコーダーが選択されている必要があります。値: 0xC0AA0003
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210

解説(Remarks)

要求された回転速度制御を取得するには、IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV メソッドを呼び出します。

回転速度制御の種類には次のものがあります。

CLV (Constant Linear Velocity、線速度一定)。ディスクは一定の速度で書き込まれます。標準的な回転制御です。
CAV (Constant Angular Velocity、角速度一定)。ディスクは連続的に増加する速度で書き込まれます。
ZCAV (Zone Constant Linear Velocity、ゾーン線速度一定)。ディスクは複数のゾーンに分割され、ゾーンごとに書き込み速度が上がります。これは CAV の不完全な形態です。
PCAV (Partial Constant Angular Velocity、部分角速度一定)。ディスクの速度は指定された速度まで上昇します。その速度に達すると、ディスクの書き込みが終わるまで指定された速度で回転します。

vtbl 36 HRESULT get_SupportedWriteSpeeds(SAFEARRAY** supportedSpeeds)

ディスクレコーダーと現在のメディアがサポートする書き込み速度の一覧を取得します。(IDiscFormat2Data.get_SupportedWriteSpeeds)

supportedSpeeds

SAFEARRAY**

out

ディスクレコーダーと現在のメディアがサポートする書き込み速度の一覧です。配列の各要素は VT_UI4 型の VARIANT です。VARIANT の ulVal メンバーには、1 秒あたりに書き込まれるセクター数が格納されます。

戻り値

戻り値	説明
E_IMAPI_RECORDER_REQUIRED	この要求には、現在のディスクレコーダーが選択されている必要があります。値: 0xC0AA0003
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。注意この値は NULL ポインターを示すものではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE	ドライブが回復不能なエラー情報を返したため、書き込みに失敗しました。値: 0xC0AA0301

解説(Remarks)

この一覧に含まれる速度を、IDiscFormat2Data::SetWriteSpeed メソッドを呼び出す際の書き込み速度として使用できます。

レコーダーと現在のメディアがサポートする書き込み構成の一覧を取得するには、IDiscFormat2Data::get_SupportedWriteSpeedDescriptors メソッドを呼び出します。

vtbl 37 HRESULT get_SupportedWriteSpeedDescriptors(SAFEARRAY** supportedSpeedDescriptors)

ディスクレコーダーと現在のメディアがサポートする詳細な書き込み構成の一覧を取得します。(IDiscFormat2Data.get_SupportedWriteSpeedDescriptors)

supportedSpeedDescriptors

SAFEARRAY**

out

ディスクレコーダーと現在のメディアがサポートする詳細な書き込み構成の一覧です。配列の各要素は VT_Dispatch 型の VARIANT です。VARIANT の pdispVal メンバーに対して IWriteSpeedDescriptor インターフェイスをクエリしてください。このインターフェイスには、メディアの種類、書き込み速度、回転速度制御の種類が含まれます。

戻り値

戻り値	説明
E_IMAPI_RECORDER_REQUIRED	この要求には、現在のディスクレコーダーが選択されている必要があります。値: 0xC0AA0003
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。注意この値は NULL ポインターを示すものではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE	ドライブが回復不能なエラー情報を返したため、書き込みに失敗しました。値: 0xC0AA0301

解説(Remarks)

レコーダーと現在のメディアがサポートする書き込み速度の一覧を取得するには、IDiscFormat2Data::get_SupportedWriteSpeeds メソッドを呼び出します。

vtbl 38 HRESULT put_ForceOverwrite(VARIANT_BOOL value)

上書き可能なメディアの種類において、データライターがディスクを上書きする必要があるかどうかを指定します。(Put)

value

上書き可能なメディアの種類でデータライターがディスクを上書きする必要がある場合は VARIANT_TRUE、それ以外の場合は VARIANT_FALSE です。既定値は VARIANT_FALSE です。

戻り値

S_OK が返されますが、実装によっては他の成功コードが返されることもあります。

vtbl 39 HRESULT get_ForceOverwrite(VARIANT_BOOL* value)

上書き可能なメディアの種類において、データライターがディスクを上書きする必要があるかどうかを示します。(Get)

value

out

上書き可能なメディアの種類でデータライターがディスクを上書きする必要がある場合は VARIANT_TRUE、それ以外の場合は VARIANT_FALSE です。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003

vtbl 40 HRESULT get_MultisessionInterfaces(SAFEARRAY** value)

使用可能なマルチセッションインターフェイスの一覧を取得します。

value

SAFEARRAY**

out

使用可能なマルチセッションインターフェイスの一覧です。配列の各要素は VT_DISPATCH 型の VARIANT です。VARIANT の pdispVal メンバーに対して、IMultisession インターフェイスを継承する任意のインターフェイス (たとえば IMultisessionSequential) をクエリしてください。

戻り値

戻り値	説明
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E

注意このメソッドは、空の光学メディアに対して呼び出してもエラーを返しません。

解説(Remarks)

配列には、常に少なくとも 1 つの要素が含まれます。

vtbl 41 HRESULT Write(IStream* data)

データストリームをデバイスに書き込みます。

data

IStream*

書き込むデータストリームの IStream インターフェイスです。

戻り値

戻り値	説明
E_IMAPI_RECORDER_COMMAND_TIMEOUT	デバイスがタイムアウト期間内にコマンドを受け付けませんでした。デバイスが不整合な状態になっているか、コマンドのタイムアウト値を大きくする必要がある可能性があります。値: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	デバイスがコマンドに対して予期しないデータまたは無効なデータを報告しました。値: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	メディアが裏返しに挿入されています。値: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	ドライブが準備中であると報告しました。しばらくしてから要求をやり直してください。値: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	デバイスにメディアが入っていません。値: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	メディアは現在フォーマット中です。メディアを使用する前に、フォーマットが完了するまでお待ちください。値: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	書き込みの終了処理など、長時間かかる操作を実行中であるとドライブが報告しました。ドライブは長時間使用できない可能性があります。値: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	ドライブが書き込みを継続できるだけの速さでデータを受け取れなかったため、書き込みに失敗しました。ソースデータをローカルコンピューターに移動する、書き込み速度を下げる、または「buffer underrun free」設定を有効にすることで、この問題が解決する場合があります。値: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	メディアに互換性がないか、物理フォーマットが不明です。値: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 構造が存在しません。互換性のないドライブまたはメディアを使用していることが原因の可能性があります。値: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	要求されたモードページ (およびその種類) が存在しないとデバイスが報告しました。値: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	MODE SELECT コマンドのモードページで指定されたパラメーターの組み合わせがサポートされていないとドライブが報告しました。値: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	メディアが書き込み禁止であるとドライブが報告しました。値: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	メディアの速度がデバイスと互換性がありません。デバイスがサポートする速度範囲より高速または低速なメディアを使用していることが原因の可能性があります。値: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	指定されたハンドルは無効です。値: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	指定されたネットワークリソースまたはデバイスは既に利用できません。値: 55
E_IMAPI_RECORDER_LOCKED	前回の操作でこのレコーダーに関連付けられたデバイスが排他的にロックされているため、この操作は失敗しました。値: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE	ドライブが回復不能なエラー情報を返したため、書き込みに失敗しました。値: 0xC0AA0301
E_IMAPI_RECORDER_REQUIRED	この要求には、現在のディスクレコーダーが選択されている必要があります。値: 0xC0AA0003
S_IMAPI_ROTATIONADJUSTED	要求された回転制御の種類がドライブでサポートされていなかったため、回転制御の種類が調整されました。値: 0x00AA0005
S_IMAPI_SPEEDADJUSTED	要求された書き込み速度がドライブでサポートされていなかったため、速度が調整されました。値: 0x00AA0004
S_IMAPI_BOTHADJUSTED	要求された書き込み速度と回転制御の種類がドライブでサポートされていなかったため、どちらも調整されました。値: 0x00AA0006
E_IMAPI_DF2DATA_RECORDER_NOT_SUPPORTED	このデバイスは、このディスクフォーマットが必要とする操作をサポートしていません。値: 0xC0AA0407
E_IMAPI_REQUEST_CANCELLED	要求は取り消されました。値: 0xC0AA0002
E_IMAPI_DF2DATA_WRITE_IN_PROGRESS	現在、書き込み操作が実行中です。値: 0xC0AA0400
E_IMAPI_DF2DATA_STREAM_NOT_SUPPORTED	指定された IStream オブジェクトのサイズが無効です。サイズはセクターサイズ 2048 の倍数である必要があります。値: 0xC0AA0403
E_IMAPI_DF2DATA_MEDIA_IS_NOT_SUPPORTED	現在のメディアの種類はサポートされていません。値: (HRESULT)0xC0AA0406
E_INVALIDARG	1 つ以上の引数が有効ではありません。値: 0x80070057
E_POINTER	ポインターが有効ではありません。値: 0x80004003
E_FAIL	原因不明のエラーです。値: 0x80004005
E_OUTOFMEMORY	必要なメモリを割り当てられませんでした。値: 0x8007000E
E_NOTIMPL	実装されていません。値: 0x80004001

解説(Remarks)

このメソッドを呼び出す前に、次のメソッドを呼び出しておく必要があります。

また、既定値がアプリケーションに適さない場合は、次のメソッドの呼び出しも検討してください。

このメソッドは同期的であり、指定された IStream がメディアに記録されるまで制御は戻りません。書き込み操作の進行状況を把握するには、DDiscFormat2DataEvents インターフェイスを実装する必要があります。スクリプトでイベントハンドラーを実装する方法の例については、「Monitoring Progress With Events」を参照してください。

順次記録方式のディスクでは、指定された IStream は新しいセッションとして記録されます。書き換え可能ディスクでは、指定された IStream は常にセクター 0 から記録されますが、IStream インターフェイスを提供するオブジェクトは、記録が必要なセクターを列挙する IBlockRangeList インターフェイスも提供できます。IBlockRangeList インターフェイスは、マルチセッションのシナリオで変更されていないセクターの再書き込みを避けるために使用します。IStream を提供するオブジェクトが IBlockRangeList を提供しない場合は、IStream 全体を記録する必要があるものとみなされます。

vtbl 42 HRESULT CancelWrite()

現在の書き込み操作を取り消します。(IDiscFormat2Data.CancelWrite)

戻り値

戻り値	説明
E_IMAPI_DF2DATA_WRITE_NOT_IN_PROGRESS	現在、実行中の書き込み操作はありません。値: 0xC0AA0401
E_FAIL	原因不明のエラーです。値: 0x80004005

解説(Remarks)

書き込み操作を取り消すには、実装した DDiscFormat2DataEvents::Update イベントハンドラーからこのメソッドを呼び出す必要があります。

メディア固有の要件により、このメソッドを呼び出してもすべてのメディアで書き込み操作がただちに取り消されるわけではないことに注意してください。たとえば CD への書き込みでは、書き込み操作がさらに最大 3 分間継続することがあります。

このメソッドを実行すると、メディアは不確定な状態のままになります。書き換え可能メディアの場合は、以降の使用に備えてメディアを準備するために、このメソッドの呼び出し後に IDiscFormat2Erase::EraseMedia メソッドを呼び出してください。

vtbl 43 HRESULT SetWriteSpeed(INT RequestedSectorsPerSecond, VARIANT_BOOL RotationTypeIsPureCAV)

ディスクレコーダーの書き込み速度を設定します。(IDiscFormat2Data.SetWriteSpeed)

RequestedSectorsPerSecond

INT

1 秒あたりのディスクセクター数で表した、要求する書き込み速度です。

0xFFFFFFFF (-1) は、そのメディアでサポートされる最速の速度で書き込みを行うことを要求します。これが既定値です。

RotationTypeIsPureCAV