Metodo IDiscMaster::RecordDisc (imapi.h)

Burns the staged image to media in the active disc recorder.Burns the staged image to media in the active disc recorder.

Sintassi

HRESULT RecordDisc(
  [in] boolean bSimulate,
  [in] boolean bEjectAfterBurn
);

Parametri

[in] bSimulate

Indica se il supporto viene bruciato. Se questo parametro è TRUE, i supporti nel registratore di dischi attivi non vengono effettivamente bruciati. Viene invece eseguita una bruciatura simulata. La simulazione è un buon test di un registratore di dischi, perché la maggior parte delle operazioni viene eseguita come in una vera ustione. Se questo parametro è FALSE, il supporto nel registratore viene effettivamente bruciato.

[in] bEjectAfterBurn

Indica se espellere il supporto dopo la masterizzazione. Se questo parametro è TRUE, il supporto viene espulso. Se questo parametro è FALSE, il supporto non viene espulso.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Commenti

Questo metodo restituisce quando il burn è completo, anche se i callback di stato vengono eseguiti se registrati con il metodo ProgressAdvise . Eventuali errori causano la restituzione di questo metodo, con un'azione correttiva piccola o nulla da parte di questo metodo.

I dati dell'immagine a fasi non sono validi dopo una chiamata a RecordDisc. In questo modo l'applicazione può eseguire una masterizzazione simulata o effettiva del supporto. Per motivi di sicurezza, il contenuto del file stash viene cancellato automaticamente dopo il completamento della prima chiamata a questo metodo. È necessario riformulare un disco per masterizzarlo di nuovo.

Il metodo RecordDisc prevede di usare supporti vuoti per l'audio. In caso contrario, potrebbe essere necessario cancellare il supporto CD-RW in un'unità CD-RW. Vedere IDiscRecorder::Erase.

Il metodo SetActiveDiscRecorder determina se è presente un disco multisessione IMAPI nell'unità attiva al momento dell'impostazione. In questo caso, IMAPI passa automaticamente alla modalità multisessione. Se in modalità multisessione e viene effettuata una chiamata a RecordDisc, lo stesso disco che ha stabilito la modalità multisessione deve essere nel registratore attivo o verrà restituito un codice di errore di IMAPI_E_WRONGDISC.

Requisiti

Vedi anche

IDiscMaster