Método IDiscMaster::RecordDisc (imapi.h)
Quema la imagen almacenada provisionalmente en el medio de la grabadora de disco activa.
Sintaxis
HRESULT RecordDisc(
[in] boolean bSimulate,
[in] boolean bEjectAfterBurn
);
Parámetros
[in] bSimulate
Indica si se ha quemado el medio. Si este parámetro es TRUE, los medios de la grabadora de disco activo no se queman realmente. En su lugar, se realiza una grabación simulada. La simulación es una buena prueba de una grabadora de disco, ya que la mayoría de las operaciones se realizan como en una grabación real. Si este parámetro es FALSE, el medio de la grabadora se quema realmente.
[in] bEjectAfterBurn
Indica si se va a expulsar el medio después de la grabación. Si este parámetro es TRUE, se expulsa el medio. Si este parámetro es FALSE, el medio no se expulsa.
Valor devuelto
S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
Comentarios
Este método devuelve una vez completada la grabación, aunque se realizan devoluciones de llamada de progreso si se registran con el método ProgressAdvise . Cualquier error hace que este método devuelva, con poca o ninguna acción correctiva por parte de este método.
Los datos de imagen almacenados provisionalmente no son válidos después de una llamada a RecordDisc. Esto permite a la aplicación realizar una grabación simulada o real de los medios. Por seguridad, el contenido del archivo stash se borra automáticamente después de completar correctamente la primera llamada a este método. Se debe volver a guardar un disco para volver a grabarlo.
El método RecordDisc espera trabajar con medios en blanco para audio. De lo contrario, es posible que los medios deban borrarse (por ejemplo, medios CD-RW en una unidad CD-RW). Consulte IDiscRecorder::Erase.
El método SetActiveDiscRecorder determina si hay un disco de varias sesiones imAPI en la unidad activa tras la configuración. Si es así, IMAPI entra automáticamente en modo multisesión. Si en el modo multisesión y se realiza una llamada a RecordDisc, el mismo disco que estableció el modo de varias sesiones debe estar en la grabadora activa o se devolverá un código de error de IMAPI_E_WRONGDISC.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi.h |
| Library | Uuid.lib |
| Archivo DLL | Actxprxy.dll |