IDiscMaster

IDiscMaster インターフェイスを使用すると、アプリケーションはイメージマスタリング API を予約し、イメージマスタリングオブジェクトがサポートするディスクマスタリング形式とディスクレコーダーを列挙し、ディスクへのシミュレーション書き込みまたは実際の書き込みを開始できます。

クライアントアプリケーションからアクセスできるように、上位レベルの IMAPI オブジェクトを開きます。

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

この disc master オブジェクトがサポートするすべてのディスクマスタリング形式の列挙子を取得します。ディスクマスタリング形式は、ステージングされたイメージファイル内のコンテンツの構造 (データ/オーディオ) と、そのステージングイメージを管理するインターフェイスを指定します。

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

MSDiscMasterObj は、サポートする形式をそのインターフェイス ID で識別する列挙子を返します。現在、形式は 2 つあります。IID_IRedbookDiscMaster ( IRedbookDiscMaster) と IID_IJolietDiscMaster ( IJolietDiscMaster) です。

IEnumDiscMasterFormats は、 IEnumXXXX に記載されているとおり、標準的な COM 列挙子です。Next を呼び出すたびに、サポートされるディスクマスタリング形式ごとに 1 つの IID を格納した IID の配列が返されます。アクティブな形式を選択し、その形式固有のインターフェイスへのポインターを取得するには、 SetActiveDiscMasterFormat を使用します (インターフェイスがアクティブな形式に関連付けられないため、QueryInterface は使用しないでください)。

アクティブなディスクレコーダー形式を取得します。アクティブな形式は、ステージングされたイメージファイルのコンテンツの構造 (オーディオ/データ) と、そのステージングイメージを操作するために使用する必要がある COM インターフェイスの両方を指定します。

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

MSDiscMasterObj は、2 つの形式の IID をサポートします。IID_IRedbookDiscMaster (IRedbookDiscMaster) と IID_IJolietDiscMaster (IJolietDiscMaster) です。アクティブな形式を選択し、その形式固有のインターフェイスへのポインターを取得するには、 SetActiveDiscMasterFormat を使用します。

現在アクティブなディスクレコーダー形式を設定します。アクティブな形式は、ステージングされたイメージファイルのコンテンツの構造 (オーディオ/データ) と、そのステージングイメージを操作するために使用する必要がある COM インターフェイスの両方を指定します。

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

このメソッドの呼び出しに成功すると、現在ステージングされているイメージの内容が消去されます。さらに、サポートされるディスクレコーダーの一覧が変化する場合があります。これは、すべてのレコーダーがすべての形式をサポートしているわけではないためです。レコーダー一覧の変更は IDiscMasterProgressEvents::NotifyPnPActivity によって通知されます。現在選択されているレコーダーが新しいサポート対象デバイスの集合に含まれていない場合、アクティブなレコーダーは存在しない状態になります ( Open を最初に呼び出した直後の状態と同様です)。この場合、アプリケーションは書き込みを開始する前に新しいアクティブレコーダーを選択する必要があります。

MSDiscMasterObj は、次の IID のみをサポートします。IID_IRedbookDiscMaster (IRedbookDiscMaster) と IID_IJolietDiscMaster (IJolietDiscMaster) です。形式が設定されていない場合、既定は Joliet 形式です。 EnumDiscMasterFormats とこのメソッドを使用して形式マスターを選択するのは、各アプリケーションの責任です。

アクティブなディスクマスタリング形式がサポートするすべてのディスクレコーダーの列挙子を取得します。

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

IEnumDiscRecorders は、 IEnumXXXX に記載されているとおり、標準的な COM 列挙子です。Next を呼び出すたびに、 IDiscRecorder へのポインターの配列が返されます。各レコーダーインターフェイスは、基になる物理ディスクレコーダーに既に関連付けられた 1 つの利用可能なレコーダーを表します。

利用可能なレコーダーの一覧は、プラグアンドプレイによるデバイスの接続や取り外し、または SetActiveDiscMasterFormat の呼び出しによって変化する場合があります。アプリケーションは、 IDiscMasterProgressEvents::NotifyPnPActivity の呼び出しを受け取ることで、これらの変更を通知されます。各列挙子は列挙時点でサポートされていたデバイスのスナップショットを保持しているため、変更が発生した場合、アプリケーションはこのメソッドを再度呼び出して新しい列挙子を取得する必要があります。

デバイスが取り外された場合でも、基になる物理デバイスが存在しなくなったそのポインターと IDiscRecorder インターフェイスは有効なままである必要があります。この場合、 IDiscRecorder に対する操作やディスクへの記録要求は IMAPI_E_DEVICE_NOTPRESENT を返すことがあります。

MaxWriteSpeed プロパティは、このメソッドが呼び出されたときに更新されます。既定の設定は、利用可能な最も高い書き込み速度です。

アクティブなディスクレコーダーへのインターフェイスポインターを取得します。アクティブなディスクレコーダーとは、RecordDisc が呼び出されたときに書き込みが行われるレコーダーです。

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

既定のアクティブディスクレコーダーは存在しません。このメソッドを使用するアプリケーションは、書き込みを開始する前に、アクティブなマスタリング形式とアクティブなディスクレコーダーの両方を明示的に選択する必要があります。

アクティブなディスクレコーダーを選択します。アクティブなディスクレコーダーとは、RecordDisc が呼び出されたときに書き込みが行われるレコーダーです。

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

SetActiveDiscRecorder は、使用するメディアを挿入した後、かつ IJolietDiscMaster::AddData を呼び出す前に呼び出す必要があります。

Joliet 形式がアクティブな状態でレコーダーを選択すると、IMAPI は現在挿入されているレコーダー内のディスクから情報を読み取ります。そのディスクが以前に IMAPI で作成された Joliet ディスクであり、別のセッションを追加する空き領域がある場合、IMAPI は自動的にマルチセッションモードに設定されます。 RecordDisc を呼び出す際には、このディスクがアクティブなレコーダーに入っている必要があります。

MaxWriteSpeed プロパティは、このメソッドが呼び出されたときに更新されます。既定の設定は、最も高い書き込み速度です。

未書き込みのイメージ (現在のスタッシュファイル) の内容を消去します。

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

スタッシュファイルは、メディアに記録する前にディスクをステージングするために使用される内部構造です。

SetActiveDiscRecorder は、アクティブなドライブに IMAPI のマルチセッションディスクが入っているかどうかを判定します。入っている場合、IMAPI は自動的にマルチセッションモードに入ります。マルチセッションモードが確立された後に ClearFormatContent を使用すると、IMAPI はシングルセッションモードに戻ります。つまり、 RecordDisc による書き込みには空のディスクが必要になります。

進行状況通知を受け取るためにアプリケーションを登録します。

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

アプリケーションに対する進行状況通知を解除します。

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

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

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

このメソッドは書き込みが完了したときに戻りますが、 ProgressAdvise メソッドで登録されている場合は進行状況のコールバックが行われます。エラーが発生するとこのメソッドは戻り、このメソッド側での修復処理はほとんど、あるいはまったく行われません。

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

RecordDisc メソッドは、オーディオの場合は空のメディアを対象として動作することを前提としています。それ以外の場合は、メディアの消去が必要になることがあります (たとえば、CD-RW ドライブ内の CD-RW メディアなど)。 IDiscRecorder::Erase を参照してください。

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

他のアプリケーションが使用できるように、インターフェイスを閉じます。

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

RecordDisc の呼び出しによってメディアに確定されていないコンテンツは失われます。

既に閉じられているインターフェイスを閉じた場合は S_OK が返されます。