IDiscMaster::RecordDisc-Methode (imapi.h)
Brennt das inszenierte Bild auf medien im aktiven Datenträgerrekorder.
Syntax
HRESULT RecordDisc(
[in] boolean bSimulate,
[in] boolean bEjectAfterBurn
);
Parameter
[in] bSimulate
Gibt an, ob das Medium gebrannt wird. Wenn dieser Parameter TRUE ist, werden die Medien im aktiven Datenträgerrecorder nicht tatsächlich gebrannt. Stattdessen wird ein simulierter Brennvorgang ausgeführt. Die Simulation ist ein guter Test eines Disc Recorders, da die meisten Vorgänge wie bei einer echten Verbrennung ausgeführt werden. Wenn dieser Parameter FALSE ist, werden die Medien im Rekorder tatsächlich gebrannt.
[in] bEjectAfterBurn
Gibt an, ob das Medium nach dem Brennen ausgeworfen werden soll. Wenn dieser Parameter TRUE ist, wird das Medium ausgeworfen. Wenn dieser Parameter FALSE ist, wird das Medium nicht ausgeworfen.
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
Diese Methode gibt zurück, wenn der Brennvorgang abgeschlossen ist, obwohl Statusrückrufe durchgeführt werden, wenn sie mit der ProgressAdvise-Methode registriert werden. Alle Fehler führen dazu, dass diese Methode zurückgegeben wird, ohne dass diese Methode korrekturen kann.
Die Daten des mehrstufigen Images sind nach einem Aufruf von RecordDisc ungültig. Dadurch kann die Anwendung entweder einen simulierten oder tatsächlichen Brennvorgang des Mediums ausführen. Aus Sicherheitsgründen wird der Inhalt der Stashdatei nach erfolgreichem Abschluss des ersten Aufrufs dieser Methode automatisch gelöscht. Ein Datenträger muss neu festgelegt werden, um ihn erneut zu brennen.
Die RecordDisc-Methode erwartet, dass sie mit leeren Medien für Audiodaten funktioniert. Andernfalls müssen die Medien möglicherweise gelöscht werden (z. B. CD-RW-Medien in einem CD-RW-Laufwerk). Siehe IDiscRecorder::Erase.
Die SetActiveDiscRecorder-Methode bestimmt bei der Einstellung, ob im aktiven Laufwerk ein IMAPI-Datenträger mit mehreren Sitzungen vorhanden ist. Wenn ja, wechselt IMAPI automatisch in den Modus für mehrere Sitzungen. Wenn im Modus mit mehreren Sitzungen ein Aufruf von RecordDisc erfolgt, muss sich derselbe Datenträger, der den Modus für mehrere Sitzungen eingerichtet hat, im aktiven Recorder befinden, da sonst der Fehlercode IMAPI_E_WRONGDISC zurückgegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |