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

Apaga a mídia no gravador de disco ativo.

Sintaxe

HRESULT EraseMedia();

Valor retornado

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno	Descrição
E_POINTER	O ponteiro não é válido. Valor: 0x80004003
E_FAIL	Falha não especificada. Valor: 0x80004005
E_OUTOFMEMORY	Falha ao alocar a memória necessária. Valor: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	O dispositivo não aceitou o comando dentro do período de tempo limite. Isso pode ser causado pelo dispositivo ter inserido um estado inconsistente ou o valor de tempo limite para o comando pode precisar ser aumentado. Valor: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	O dispositivo relatou dados inesperados ou inválidos para um comando. Valor: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	A mídia é inserida de cabeça para baixo. Valor: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	A unidade informou que está em processo de preparação. Tente a solicitação novamente mais tarde. Valor: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	Não há mídia no dispositivo. Valor: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	A mídia está sendo formatada no momento. Aguarde a conclusão do formato antes de tentar usar a mídia. Valor: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	A unidade informou que está executando uma operação de longa execução, como terminar uma gravação. A unidade pode ser inutilizável por um longo período de tempo. Valor: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	A gravação falhou porque a unidade não recebeu dados rapidamente o suficiente para continuar gravando. Mover os dados de origem para o computador local, reduzir a velocidade de gravação ou habilitar uma configuração de "buffer sem execução livre" pode resolve esse problema. Valor: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	A mídia não é compatível ou de formato físico desconhecido. Valor: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	A estrutura do DVD não está presente. Isso pode ser causado por uma unidade/mídia incompatível usada. Valor: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	O dispositivo informou que a página do modo solicitado (e o tipo) não está presente. Valor: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	A unidade informou que não havia suporte para a combinação de parâmetros fornecidos na página de modo para um comando MODE SELECT. Valor: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	A unidade informou que a mídia está protegida por gravação. Valor: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	A velocidade da mídia é incompatível com o dispositivo. Isso pode ser causado pelo uso de mídia de velocidade maior ou menor do que o intervalo de velocidades com suporte pelo dispositivo. Valor: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	O identificador especificado é inválido. Valor: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	O recurso de rede ou dispositivo especificado não está mais disponível. Valor: 55
E_IMAPI_RECORDER_LOCKED	O dispositivo associado a esse gravador durante a última operação foi bloqueado exclusivamente, fazendo com que essa operação falhasse. Valor: 0xC0AA0210
E_IMAPI_ERASE_MEDIA_IS_NOT_SUPPORTED	Não há suporte para o tipo de mídia atual. Valor: 0xC0AA0909
E_IMAPI_ERASE_DRIVE_FAILED_SPINUP_COMMAND	A unidade retornou um erro para um comando START UNIT (spinup). A intervenção manual pode ser necessária. Valor: 0x80AA0908
E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR	A unidade não completou a apagamento em uma hora. A unidade pode exigir um ciclo de energia, remoção de mídia ou outra intervenção manual para retomar a operação adequada. Nota Atualmente, esse valor também será retornado se uma tentativa de executar uma apagamento na mídia CD-RW ou DVD-RW por meio da interface IDiscFormat2Erase falhar como resultado da falha da mídia.   Valor: 0x80AA0906

Comentários

Apaga a mídia de forma síncrona. O progresso pode ser relatado chamando eventos registrados do tipo DDiscFormat2EraseEvents.

Antes de chamar esse método, você deve chamar os seguintes métodos:

• IDiscFormat2Erase::p ut_Recorder
• IDiscFormat2Erase::p ut_ClientName

Você também deve considerar chamar o método IDiscFormat2Erase::p ut_FullErase se o valor padrão não for apropriado para seu aplicativo.

Esse método é síncrono. Para determinar o progresso da operação de apagamento, você deve implementar a interface DDiscFormat2EraseEvents . Para obter exemplos que mostram como implementar um manipulador de eventos em um script, consulte Monitorando o progresso com eventos.

Atualmente, o valor E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR será retornado se uma tentativa de executar uma apagamento na mídia CD-RW ou DVD-RW por meio da interface IDiscFormat2Erase falhar como resultado da falha da mídia ou de uma falha na unidade.

Requisitos

Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	imapi2.h

Confira também

IDiscFormat2Erase

IDiscFormat2Erase::get_FullErase

IDiscFormat2Erase::p ut_FullErase