IDiscMaster::SetActiveDiscRecorder-Methode (imapi.h)
Wählt einen aktiven Disc Recorder aus. Der aktive DiscRecorder ist der Rekorder, bei dem beim Aufruf von RecordDisc ein Brennen auftritt.
Syntax
HRESULT SetActiveDiscRecorder(
[in] IDiscRecorder *pRecorder
);
Parameter
[in] pRecorder
Zeiger auf die IDiscRecorder-Schnittstelle eines Disc Recorder-Objekts. Dieser Zeiger sollte von einem vorherigen Aufruf von EnumDiscRecorders zurückgegeben werden.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
Hinweise
SetActiveDiscRecorder muss aufgerufen werden, nachdem das zu verwendende Medium eingefügt wurde und vor dem Aufruf von IJolietDiscMaster::AddData.
Die Auswahl eines Recorders in einem aktiven Joliet-Format führt dazu, dass IMAPI Informationen von der aktuell installierten Aufzeichnungsaufzeichnungs-Disc liest. Wenn es sich bei diesem Datenträger um einen vorherigen IMAPI Joliet-Datenträger handelt und Platz für eine andere Sitzung hat, wird im IMAPI automatisch auf den Modus für mehrere Sitzungen festgelegt. Dieser Datenträger muss sich im aktiven Rekorder befindet, wenn RecordDisc aufgerufen wird.
Die MaxWriteSpeed-Eigenschaft wird aktualisiert, wenn diese Methode aufgerufen wird. Die Standardeinstellung ist die höchste Schreibgeschwindigkeit.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi.h |
| Bibliothek | Uuid.lib |
| DLL | Actxprxy.dll |