IDiscFormat2TrackAtOnce

このインターフェイスは、Track-At-Once モードでブランクの CD-R または CD-RW メディアにオーディオを書き込むために使用します。

スクリプトで MsftDiscFormat2TrackAtOnce オブジェクトを作成するには、CreateObject の呼び出し時にプログラム識別子として IMAPI2.MsftDiscFormat2TrackAtOnce を指定します。

書き込み操作の実行中に電源状態の遷移 (ユーザーのログオフやシステムのサスペンドなど) が発生し、書き込み処理が中断してデータが失われる可能性があります。プログラミング上の考慮事項については、Preventing Logoff or Suspend During a Burn を参照してください。

現在のメディアを排他アクセス用にロックします。(IDiscFormat2TrackAtOnce.PrepareMedia)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このメソッドを呼び出す前に、IDiscFormat2TrackAtOnce::put_ClientName メソッドを呼び出す必要があります。

また、IDiscFormat2TrackAtOnce::AddAudioTrack メソッドを呼び出す前に、IDiscFormat2TrackAtOnce::PrepareMedia メソッドを呼び出す必要があります。

書き込みが完了した後、または書き込み操作をキャンセルした後は、IDiscFormat2TrackAtOnce::ReleaseMedia メソッドを呼び出してロックを解放する必要があります。

なお、メディア変更通知 (MCN) と IDiscFormat2TrackAtOnce::put_DoNotFinalizeMedia プロパティは、セッションが閉じられるまで読み取り専用になります。

データストリームを新しいトラックとして現在のメディアに書き込みます。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このメソッドを呼び出す前に、IDiscFormat2TrackAtOnce::put_Recorder メソッドと IDiscFormat2TrackAtOnce::PrepareMedia メソッドを呼び出す必要があります。

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

• IDiscFormat2TrackAtOnce::put_BufferUnderrunFreeDisabled
• IDiscFormat2TrackAtOnce::put_ClientName
• IDiscFormat2TrackAtOnce::put_DoNotFinalizeMedia

メディアには 99 個のオーディオデータトラックを収めることができます。トラック番号は 1 から始まり、最後のトラックは 99 です。

無音 (値が 0 のデータサンプル) は、次のようにトラック書き込み操作に追加されます。

• トラックの最小サイズは 4 秒です。必要に応じて、この条件を満たすようにトラックデータが拡張されます。
• Track-At-Once 記録の性質上、連続するオーディオトラックの間には 2 秒のギャップが追加されます。このギャップは通常 PC 用のプレーヤーでは表面化しませんが、一部の家電機器では認識できる場合があります。

現在の書き込み操作をキャンセルします。(IDiscFormat2TrackAtOnce.CancelAddTrack)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

また、このメソッドを呼び出した後は、IDiscFormat2TrackAtOnce::ReleaseMedia メソッドも呼び出す必要があります。

なお、メディア固有の要件により、このメソッドを呼び出してもすべてのメディアで書き込み操作が直ちにキャンセルされるわけではありません。たとえば CD への書き込みでは、書き込み操作がさらに最大 3 分間継続することがあります。

このメソッドの呼び出し時点で、オーディオトラックの一部が既に記録されている場合があります。このメソッドはメディアを使用可能な状態に保つよう試み、キャンセルされたトラックを単に IStream が示していた長さより短いトラックとして扱います。呼び出し側は、キャンセル後にトラック数とトラックサイズを照会してディスクの状態を確認してください。

トラック書き込みセッションを閉じ、ロックを解放します。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このメソッドは、IDiscFormat2TrackAtOnce::PrepareMedia メソッドの呼び出し時に設定されたロックを解放します。書き込みセッションを閉じるとき、または IDiscFormat2TrackAtOnce::CancelAddTrack メソッドを呼び出した後には、このメソッドを呼び出す必要があります。

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このメソッドは、レコーダーの書き込み速度と回転速度制御の種類を設定します。要求した値は、レコーダーに実際に設定される値と異なる場合があります。レコーダーを指定するには、IDiscFormat2TrackAtOnce::put_Recorder メソッドを呼び出します。

要求した書き込み速度をレコーダーがサポートしている場合、ディスクデバイスはその値を使用します。サポートしていない場合、レコーダーはサポートする書き込み速度のうち要求値に最も近いものを使用します。レコーダーが使用している値は IDiscFormat2TrackAtOnce::get_CurrentWriteSpeed プロパティで確認できます。

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

回転速度制御の種類として角速度一定 (CAV) を要求してもレコーダーが CAV をサポートしていない場合、ディスクデバイスはサポートする別の種類の回転速度制御を使用します。レコーダーが使用している値は IDiscFormat2TrackAtOnce::get_CurrentRotationTypeIsPureCAV プロパティが示します。

要求した値を取得するには、IDiscFormat2TrackAtOnce::get_RequestedWriteSpeed メソッドと IDiscFormat2TrackAtOnce::get_RequestedRotationTypeIsPureCAV メソッドを呼び出します。

書き込み操作に使用する記録デバイスを設定します。(IDiscFormat2TrackAtOnce.put_Recorder)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

レコーダーは、このインターフェイスが定義するフォーマットと互換性がある必要があります。互換性を確認するには、IDiscFormat2::IsRecorderSupported メソッドを呼び出します。

書き込み操作に使用する記録デバイスを取得します。(IDiscFormat2TrackAtOnce.get_Recorder)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

Buffer Underrun Free 記録を有効にするかどうかを設定します。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

Buffer Underrun Free 記録が有効かどうかを取得します。(IDiscFormat2TrackAtOnce.get_BufferUnderrunFreeDisabled)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

メディア上に存在するオーディオトラックの数を取得します。(IDiscFormat2TrackAtOnce.get_NumberOfExistingTracks)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

次の場合、値は 0 になります。

• メディアがブランクである場合
• 書き込みセッション外でこのメソッドを呼び出した場合

1 つの連続したオーディオトラックを書き込む場合にメディア上で使用できる合計セクター数を取得します。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このプロパティはいつでも取得できますが、書き込み中はキャッシュされた値が返されます。

メディアに新しいトラックを追加するために使用できるセクター数を取得します。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

AddAudioTrack 操作の実行中に呼び出した場合、空きセクター数には現在のオーディオトラックの書き込みで使用されたセクターは反映されません。代わりに、AddAudioTrack を呼び出す直前の空きセクター数が返されます。

メディア上で使用済みのセクターの合計数を取得します。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

イベントハンドラーからこのメソッドを呼び出した場合、この数値は書き込み開始前の使用済みセクター数を表します。

オーディオトラックの書き込み後もメディアを書き込み可能な状態のままにするかどうかを設定します。(Put)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このプロパティは、IDiscFormat2TrackAtOnce::PrepareMedia メソッドを呼び出す前、または IDiscFormat2TrackAtOnce::ReleaseMedia メソッドを呼び出した後に設定できます。トラック書き込みセッションの実行中には設定できません。

このプロパティは、最初のセッションにオーディオ、2 番目のセッションにデータを収めたマルチセッション CD を作成する場合に役立ちます。

オーディオトラックの書き込み後もメディアを書き込み可能な状態のままにするかどうかを取得します。(Get)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

トラック書き込みセッション内でメディアに配置されたオーディオトラックの目次 (TOC) を取得します。

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

このプロパティには、トラック書き込みセッション外ではアクセスできません。また、ディスクがブランクの場合もアクセスできません。

ディスクデバイスに入っているメディアの種類を取得します。(IDiscFormat2TrackAtOnce.get_CurrentPhysicalMediaType)

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

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

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

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

なお、書き込み速度はメディアの書き込み速度に基づきます。メディアが交換されると、このプロパティの値が変わることがあります。

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

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

• CLV (Constant Linear Velocity、線速度一定)。ディスクは一定の速度で書き込まれます。標準的な回転制御です。
• CAV (Constant Angular Velocity、角速度一定)。ディスクは連続的に増加する速度で書き込まれます。
• ZCAV (Zone Constant Angular Velocity、ゾーン角速度一定)。ディスクはゾーンに分割され、各ゾーンを過ぎるごとに書き込み速度が増加します。これは CAV の純粋ではない形態です。
• PCAV (Partial Constant Angular Velocity、部分角速度一定)。ディスクの速度は指定された速度まで増加します。その速度に達した後は、ディスクへの書き込みが終わるまで指定された速度で回転します。

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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

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

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

成功した場合は S_OK が返されますが、実装によっては他の成功コードが返される場合があります。操作が失敗した場合は一般に次のエラーコードが返されますが、返される可能性のあるエラー値はこれらだけではありません。

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