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

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

構文

HRESULT SetActiveDiscMasterFormat(
  [in]  REFIID riid,
  [out] void   **ppUnk
);

パラメーター

[in] riid

現在アクティブな形式の IID。

[out] ppUnk

新しいディスク形式の COM インターフェイスへのポインター。

戻り値

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

解説

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

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

メモ このメソッドを呼び出すと、使用可能なレコーダーの一覧が変更される場合があります。 詳細については、「 EnumDiscRecorders 」の「解説」セクションを参照してください。

 

要件

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

関連項目

IDiscMaster