IDiscRecorder インターフェイス (imapi.h)

IDiscRecorder インターフェイスを使用すると、アクティブなディスク レコーダーというラベルが付いた単一のディスク レコーダー デバイスにアクセスできます。 MSDiscMasterObj などの IMAPI オブジェクトは、アクティブなディスク レコーダーを維持します。

IDiscRecorder オブジェクトは 1 つのハードウェア デバイスを表しますが、IDiscRecorder のすべてのインスタンスが同じハードウェア デバイスを参照している場合があります。 この場合は、 OpenExclusive を使用してそのデバイスにアクセスします。

継承

IDiscRecorder インターフェイスは、IUnknown インターフェイスから継承されます。 IDiscRecorder には、次の種類のメンバーもあります。

メソッド

IDiscRecorder インターフェイスには、これらのメソッドがあります。

IDiscRecorder::Close ディスク レコーダーへの排他アクセスを解放します。 これにより、ドライブへのファイル システム アクセスが復元されます。
IDiscRecorder::Eject 可能であれば、ディスクレコーダーのトレイのロックを解除して取り出します。
IDiscRecorder::Erase CD-RW ディスク レコーダーの場合、CD-RW メディアの消去を試みます。 完全消去とクイック消去の両方がサポートされています。
IDiscRecorder::GetBasePnPID make と model によってデバイスの特定のクラスを一貫して識別するために使用できる基本 PnP 文字列を取得します。 文字列は、アプリケーションで使用して、特定のレコーダーの種類に応じて動作をカスタマイズできます。
IDiscRecorder::GetDisplayNames 表示できるレコーダーの書式設定された名前を取得します。 名前は、デバイスの製造元と製品識別子で構成されます。
IDiscRecorder::GetPath オペレーティング システム内のデバイスへのパスを取得します。 このパスは、使用可能なディスク レコーダーを完全に識別するために、表示名と組み合わせて使用する必要があります。
IDiscRecorder::GetRecorderGUID 現在レコーダー オブジェクトに関連付けられている物理ディスク レコーダーの GUID を取得します。
IDiscRecorder::GetRecorderProperties IPropertyStorage インターフェイスへのポインターを取得します。
IDiscRecorder::GetRecorderState ディスク レコーダーの状態を取得します。
IDiscRecorder::GetRecorderType ディスク レコーダーが CD-R 型または CD-RW 型のデバイスかどうかを判断します。 これは、デバイスに現在挿入されているメディアの種類を示すものではありません。
IDiscRecorder::OpenExclusive 排他的なアクセスのためにディスクレコーダーを開きます。
IDiscRecorder::QueryMediaInfo メディアで使用されているブロックの合計数など、現在マウントされているメディアに関する情報を取得します。
IDiscRecorder::QueryMediaType レコーダーに現在挿入されているメディアの種類 (存在する場合) を検出します。
IDiscRecorder::SetRecorderProperties アプリケーションが変更するすべてのプロパティを持つオブジェクトの IPropertyStorage ポインターを受け入れます。 スパース設定がサポートされています。

解説

ディスク レコーダーがアクティブ ディスク レコーダーでない場合でも、IDiscRecorder オブジェクトで IDiscRecorder インターフェイスをすべて使用できます。 IMAPI クライアントは、最初に IDiscMaster::SetActiveDiscRecorder を呼び出す必要はありません。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	imapi.h