IDiscFormat2TrackAtOnce::AddAudioTrack メソッド (imapi2.h)
データ ストリームを新しいトラックとして現在のメディアに書き込みます。
構文
HRESULT AddAudioTrack(
[in] IStream *data
);
パラメーター
[in] data
メディア上の次のトラックとして書き込むオーディオ データの IStream インターフェイス。
データ形式には、44.1KHz、16 ビット ステレオ、生オーディオ サンプルが含まれています。 これは、Microsoft WAV オーディオ ファイル (ヘッダーなし) のオーディオ サンプルで使用されるのと同じ形式です。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
リターン コード | 説明 |
---|---|
|
ポインターが無効です。
値: 0x80004003 |
|
要求された操作は、メディアが "準備済み" の場合にのみ有効です。
値: 0xC0AA0502 |
|
現在、書き込み操作が進行中です。
値: 0xC0AA0500 |
|
CD-R および CD-RW メディアは、最大 99 のオーディオ トラックをサポートします。
値: 0xC0AA0508 |
|
指定されたオーディオ ストリームが無効です。
値: 0xC0AA050D |
|
メディアに、指定されたオーディオ トラックを追加するための十分な領域がありません。 値: 0xC0AA0509 |
|
不特定のエラー。
値: 0x80004005 |
|
1 つ以上の引数が無効です。
値: 0x80070057 |
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
|
デバイスは、タイムアウト期間内にコマンドを受け入れませんでした。 これは、デバイスが不整合な状態になったか、コマンドのタイムアウト値を増やす必要がある場合があります。
値: 0xC0AA020D |
|
デバイスは、コマンドの予期しないデータまたは無効なデータを報告しました。
値: 0xC0AA02FF |
|
メディアは上下逆に挿入されます。
値: 0xC0AA0204 |
|
ドライブから、準備中であることが報告されました。 後でもう一度要求を試してください。
値: 0xC0AA0205 |
|
デバイスにメディアがありません。
値: 0xC0AA0202 |
|
メディアは現在書式設定されています。 メディアの使用を試みる前に、フォーマットが完了するまで待ってください。
値: 0xC0AA0206 |
|
ドライブから、書き込みの完了など、実行時間の長い操作が実行されていることが報告されました。 ドライブが長期間使用できない場合があります。
値: 0xC0AA0207 |
|
ドライブが書き込みを続行するのに十分な速さでデータを受信できなかったため、書き込みに失敗しました。 ソース データをローカル コンピューターに移動したり、書き込み速度を低下させたり、"バッファー アンダーラン フリー" 設定を有効にしたりすると、この問題が解決する可能性があります。
値: 0xC0AA0300 |
|
メディアに互換性がない、または物理形式が不明です。
値: 0xC0AA0203 |
|
DVD 構造が存在しません。 これは、互換性のないドライブ/メディアが使用されている場合に発生する可能性があります。
値: 0xC0AA020E |
|
デバイスから、要求されたモード ページ (および種類) が存在しないことが報告されました。
値: 0xC0AA0201 |
|
ドライブは、MODE SELECT コマンドのモード ページで指定されたパラメーターの組み合わせがサポートされていないことを報告しました。
値: 0xC0AA0208 |
|
ドライブは、メディアが書き込み保護されていることを報告しました。
値: 0xC0AA0209 |
|
メディアの速度はデバイスと互換性がありません。 これは、デバイスでサポートされている速度の範囲よりも高いまたは低い速度メディアを使用することによって発生する可能性があります。
値: 0xC0AA020F |
|
指定されたハンドルが無効です。
値: 6 |
|
指定したネットワーク リソースまたはデバイスが使用できなくなりました。
値: 55 |
|
前回の操作中にこのレコーダーに関連付けられているデバイスが排他的にロックされているため、この操作は失敗しました。
値: 0xC0AA0210 |
|
要求は取り消されました。
値: 0xC0AA0002 |
解説
このメソッドを呼び出す前に、 IDiscFormat2TrackAtOnce::p ut_Recorder メソッドと IDiscFormat2TrackAtOnce::P repareMedia メソッドを 呼び出す必要があります。
また、次のメソッドの既定値がアプリケーションに適していない場合は、次のメソッドを呼び出すことも検討する必要があります。
- IDiscFormat2TrackAtOnce::p ut_BufferUnderrunFreeDisabled
- IDiscFormat2TrackAtOnce::p ut_ClientName
- IDiscFormat2TrackAtOnce::p ut_DoNotFinalizeMedia
メディアは、99 トラックのオーディオ データに対応できます。 トラック番号は 1 から始まります。 最後のトラックは 99 です。
無音 (ゼロを含むデータ サンプル) は、次の方法でトラック書き込み操作に追加されます。
- 最小トラック サイズは 4 秒で、必要に応じて、この要件を満たすようにトラック データが拡大されます。
- 一度にトラックを記録する性質上、連続するオーディオ トラック間に 2 秒のギャップが追加されます。 通常、このギャップは PC ベースのプレーヤーによって隠されていますが、一部の家電機器では目立つ場合があります。
要件
サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | imapi2.h |