Compartir a través de

Método IDiscFormat2Erase::EraseMedia (imapi2.h)

  • Artículo

Borra el medio en la grabadora de disco activa.

Sintaxis

HRESULT EraseMedia();

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:

Código devuelto Descripción
E_POINTER
 El puntero no es válido.

Valor: 0x80004003
E_FAIL
 Error no especificado.

Valor: 0x80004005
E_OUTOFMEMORY
 No se pudo asignar la memoria necesaria.

Valor: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT
 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 es posible que sea necesario aumentar el valor de tiempo de espera del comando.

Valor: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE
 El dispositivo notificó datos inesperados o no válidos para un comando.

Valor: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN
 El medio se inserta al revés.

Valor: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY
 La unidad informó de que está en proceso de preparación. Vuelva a intentar la solicitud más tarde.

Valor: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA
 No hay ningún medio en el dispositivo.

Valor: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS
 El medio está siendo formateado actualmente. Espere a que se complete el formato antes de intentar usar el medio.

Valor: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY
 La unidad informó de que está realizando una operación de ejecución prolongada, como finalizar una escritura. La unidad puede ser inutilizable durante un largo período de tiempo.

Valor: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING
 Error de escritura porque la unidad no recibió datos lo suficientemente rápido como para continuar escribiendo. Si se mueven los datos de origen al equipo local, se reduce la velocidad de escritura o se habilita una configuración de "búfer bajo ejecución libre" puede resolver este problema.

Valor: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE
 Los medios no son compatibles ni tienen un formato físico desconocido.

Valor: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT
 La estructura de DVD no está presente. Esto puede deberse a que se usa una unidad o medio incompatibles.

Valor: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE
 El dispositivo informó de que la página de modo solicitado (y tipo) no está presente.

Valor: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS
 La unidad notificó 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
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED
 La unidad informó de que el medio está protegido por escritura.

Valor: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
 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
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
 El identificador especificado no es válido.

Valor: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
 El recurso de red o el dispositivo especificados ya no se encuentran disponibles.

Valor: 55
E_IMAPI_RECORDER_LOCKED
 El dispositivo asociado a esta grabadora durante la última operación se ha bloqueado exclusivamente, lo que hace que se produzca un error en esta operación.

Valor: 0xC0AA0210
E_IMAPI_ERASE_MEDIA_IS_NOT_SUPPORTED
 El tipo de medio actual no es compatible.

Valor: 0xC0AA0909
E_IMAPI_ERASE_DRIVE_FAILED_SPINUP_COMMAND
 La unidad devolvió un error para un comando START UNIT (spinup). Puede ser necesaria la intervención manual.

Valor: 0x80AA0908
E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR
 La unidad no completó la borrado en una hora. La unidad puede requerir un ciclo de alimentación, eliminación de medios u otra intervención manual para reanudar el funcionamiento adecuado.
Nota Actualmente, este valor también se devolverá si se produce un error en un intento de borrar en medios CD-RW o DVD-RW a través de la interfaz IDiscFormat2Erase como resultado de que el medio sea incorrecto.
 
Valor: 0x80AA0906

Comentarios

Borra los medios de forma sincrónica. El progreso se puede notificar llamando a eventos registrados de tipo DDiscFormat2EraseEvents.

Antes de llamar a este método, debe llamar a los métodos siguientes:

También debe considerar la posibilidad de llamar al método IDiscFormat2Erase::p ut_FullErase si su valor predeterminado no es adecuado para la aplicación.

Este método es sincrónico. Para determinar el progreso de la operación de borrado, debe implementar la interfaz DDiscFormat2EraseEvents . Para obtener ejemplos que muestran cómo implementar un controlador de eventos en un script, consulte Supervisión del progreso con eventos.

Actualmente, se devuelve el valor de E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR si se produce un error en un intento de borrar en medios CD-RW o DVD-RW a través de la interfaz IDiscFormat2Erase como resultado de que el medio sea incorrecto o se produzca un error en la unidad.

Requisitos

   
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

Consulte también

IDiscFormat2Erase

IDiscFormat2Erase::get_FullErase

IDiscFormat2Erase::p ut_FullErase