次の方法で共有

IDiscMaster::RecordDisc メソッド (imapi.h)

  • [アーティクル]

アクティブなディスク レコーダー内のメディアにステージングされたイメージを書き込みます。

構文

HRESULT RecordDisc(
  [in] boolean bSimulate,
  [in] boolean bEjectAfterBurn
);

パラメーター

[in] bSimulate

メディアが書き込まれたかどうかを示します。 このパラメーターが TRUE の場合、アクティブなディスク レコーダー内のメディアは実際には書き込まれません。 代わりに、シミュレートされたバーンが実行されます。 ほとんどの操作は実際のバーンのように実行されるため、シミュレーションはディスクレコーダーの優れたテストです。 このパラメーターが FALSE の場合、レコーダー内のメディアは実際に書き込まれます。

[in] bEjectAfterBurn

書き込み後にメディアを取り出すかどうかを示します。 このパラメーターが TRUE の場合、メディアは取り出されます。 このパラメーターが FALSE の場合、メディアは取り出されません。

戻り値

S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

注釈

このメソッドは、書き込みが完了すると を返しますが、 ProgressAdvise メソッドに登録されている場合は進行状況コールバックが行われます。 エラーが発生すると、このメソッドは、このメソッドの一部に対して修正アクションがほとんどまたはまったく発生せず、このメソッドが返されます。

ステージングされたイメージ データは、 RecordDisc の呼び出し後に無効です。 これにより、アプリケーションはメディアのシミュレートされた書き込みまたは実際の書き込みのいずれかを実行できます。 セキュリティのため、このメソッドの最初の呼び出しが正常に完了すると、stash ファイルの内容が自動的にクリアされます。 ディスクをもう一度書き込むには、ディスクを再び取り付ける必要があります。

RecordDisc メソッドは、オーディオ用の空のメディアで動作することを想定しています。 そうしないと、メディアを消去する必要がある場合があります (CD-RW ドライブの CD-RW メディアなど)。 「IDiscRecorder::Erase」を参照してください。

SetActiveDiscRecorder メソッドは、設定時にアクティブ ドライブに IMAPI マルチセッション ディスクがあるかどうかを判断します。 その場合、IMAPI は自動的にマルチセッション モードになります。 マルチセッション モードで RecordDisc に対して呼び出しが行われた場合、マルチセッション モードを確立したのと同じディスクがアクティブ レコーダーに存在する必要があります。または、IMAPI_E_WRONGDISCのエラー コードが返されます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー imapi.h
Library Uuid.lib
[DLL] Actxprxy.dll

こちらもご覧ください

IDiscMaster