IDiscMaster::GetActiveDiscRecorder メソッド (imapi.h)
アクティブなディスク レコーダーへのインターフェイス ポインターを取得します。 アクティブなディスク レコーダーは、 RecordDisc が呼び出されたときに書き込みが発生するレコーダーです。
構文
HRESULT GetActiveDiscRecorder(
[out] IDiscRecorder **ppRecorder
);
パラメーター
[out] ppRecorder
現在選択されているディスク レコーダーの IDiscRecorder インターフェイスへのポインター。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
解説
既定のアクティブ ディスク レコーダーはありません。 この方法を使用するアプリケーションでは、書き込みを開始する前に、アクティブなマスタリング形式とアクティブディスクレコーダーの両方を選択する必要があります。
Note
アクティブディスクレコーダーは、デバイスを取り外すか、アクティブなディスクマスタリングフォーマットを変更することによって無効にすることができます。 たとえば、アプリケーションの実行中に USB CD-R デバイスがコンピューターから切断される場合があります (アプリケーションは IDiscMasterProgressEvents::NotifyPnPActivity の呼び出しによってこの条件に対して警告されます)。 どちらの場合も、新しいアクティブディスクレコーダーを選択する必要があります。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi.h |
| Library | Uuid.lib |
| [DLL] | Actxprxy.dll |