Método IDiscRecorder2::InitializeDiscRecorder (imapi2.h)
Asocia el objeto al dispositivo de disco especificado.
Sintaxis
HRESULT InitializeDiscRecorder(
[in] BSTR recorderUniqueId
);
Parámetros
[in] recorderUniqueId
Cadena que contiene el identificador único del dispositivo.
Valor devuelto
S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
| Código devuelto | Descripción |
|---|---|
|
Uno o varios argumentos no son válidos.
Valor: 0x80070057 |
|
El valor de cchDest es 0 o mayor que STRSAFE_MAX_CCH. |
|
Error no especificado.
Valor: 0x80004005 |
|
No se pudo asignar la memoria necesaria.
Valor: 0x8007000E |
|
El dispositivo no pudo aceptar el comando dentro del período de tiempo de espera. Esto puede deberse a que el dispositivo ha entrado en un estado incoherente o puede que sea necesario aumentar el valor de tiempo de espera del comando.
Valor: 0xC0AA020D |
|
El dispositivo notificó datos inesperados o no válidos para un comando.
Valor: 0xC0AA02FF |
|
El medio se inserta al revés.
Valor: 0xC0AA0204 |
|
La unidad informó de que está en proceso de preparación. Vuelva a intentar la solicitud más tarde.
Valor: 0xC0AA0205 |
|
No hay ningún medio en el dispositivo.
Valor: 0xC0AA0202 |
|
El medio está siendo formateado actualmente. Espere a que se complete el formato antes de intentar usar el medio.
Valor: 0xC0AA0206 |
|
La unidad informó de que está realizando una operación de larga duración, como finalizar una escritura. La unidad puede no ser utilizable durante un largo período de tiempo.
Valor: 0xC0AA0207 |
|
Error de escritura porque la unidad no recibió datos lo suficientemente rápido como para continuar escribiendo. Mover los datos de origen al equipo local, reducir la velocidad de escritura o habilitar una configuración de "búfer bajo ejecución libre" puede resolver este problema.
Valor: 0xC0AA0300 |
|
El medio no es compatible o con un formato físico desconocido.
Valor: 0xC0AA0203 |
|
La estructura de DVD no está presente. Esto puede deberse a que se usa una unidad o un medio incompatibles.
Valor: 0xC0AA020E |
|
El dispositivo informó de que la página de modo solicitado (y tipo) no está presente.
Valor: 0xC0AA0201 |
|
La unidad informó de que no se admitía la combinación de parámetros proporcionados en la página de modo para un comando MODE SELECT.
Valor: 0xC0AA0208 |
|
La unidad informó de que el medio está protegido por escritura.
Valor: 0xC0AA0209 |
|
La velocidad del medio no es compatible con el dispositivo. Esto puede deberse al uso de medios de mayor o menor velocidad que el intervalo de velocidades compatibles con el dispositivo.
Valor: 0xC0AA020F |
|
El identificador especificado no es válido.
Valor: 6 |
|
El recurso de red o el dispositivo especificados ya no se encuentran disponibles.
Valor: 55 |
|
El dispositivo asociado a esta grabadora durante la última operación se ha bloqueado exclusivamente, lo que provoca un error en esta operación.
Valor: 0xC0AA0210 |
Comentarios
Debe inicializar la grabadora antes de llamar a cualquiera de los métodos de esta interfaz.
Para recuperar una lista de dispositivos en el equipo y sus identificadores únicos, llame al método IDiscMaster2::get__NewEnum .
Este método no producirá un error en una unidad que esté bloqueada exclusivamente. Sin embargo, si la unidad está bloqueada exclusivamente, varios de los métodos de esta interfaz pueden devolver E_IMAPI_RECORDER_LOCKED. Para determinar quién tiene acceso exclusivo, llame al método IDiscRecorder2::get_ExclusiveAccessOwner .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi2.h |