Condividi tramite


Metodo IDiscFormat2Erase::EraseMedia (imapi2.h)

Cancella i supporti nel registratore di dischi attivi.

Sintassi

HRESULT EraseMedia();

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:

Codice restituito Descrizione
E_POINTER
Puntatore non valido.

Valore: 0x80004003

E_FAIL
Errore non specificato.

Valore: 0x80004005

E_OUTOFMEMORY
Impossibile allocare la memoria richiesta.

Valore: 0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
Il dispositivo non è riuscito ad accettare il comando entro il periodo di timeout. Ciò può essere causato dall'immissione di uno stato incoerente del dispositivo oppure potrebbe essere necessario aumentare il valore di timeout per il comando.

Valore: 0xC0AA020D

E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE
Il dispositivo ha segnalato dati imprevisti o non validi per un comando.

Valore: 0xC0AA02FF

E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN
Il supporto viene inserito a capovolto.

Valore: 0xC0AA0204

E_IMAPI_RECORDER_MEDIA_BECOMING_READY
L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento.

Valore: 0xC0AA0205

E_IMAPI_RECORDER_MEDIA_NO_MEDIA
Non sono presenti supporti nel dispositivo.

Valore: 0xC0AA0202

E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS
Il supporto è attualmente formattato. Attendere il completamento del formato prima di tentare di usare il supporto.

Valore: 0xC0AA0206

E_IMAPI_RECORDER_MEDIA_BUSY
L'unità ha segnalato che sta eseguendo un'operazione a esecuzione prolungata, ad esempio il completamento di una scrittura. L'unità può essere inutilizzabile per un lungo periodo di tempo.

Valore: 0xC0AA0207

E_IMAPI_LOSS_OF_STREAMING
La scrittura non è riuscita perché l'unità non ha ricevuto dati abbastanza rapidamente per continuare la scrittura. Lo spostamento dei dati di origine nel computer locale, la riduzione della velocità di scrittura o l'abilitazione di un'impostazione "buffer underrun free" può risolvere questo problema.

Valore: 0xC0AA0300

E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE
Il supporto non è compatibile o con un formato fisico sconosciuto.

Valore: 0xC0AA0203

E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT
La struttura DVD non è presente. Ciò può essere causato dall'uso di unità/supporto incompatibili.

Valore: 0xC0AA020E

E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE
Il dispositivo ha segnalato che la pagina in modalità richiesta (e tipo) non è presente.

Valore: 0xC0AA0201

E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS
L'unità ha segnalato che la combinazione di parametri forniti nella pagina della modalità per un comando MODE SELECT non è supportata.

Valore: 0xC0AA0208

E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED
L'unità ha segnalato che il supporto è protetto da scrittura.

Valore: 0xC0AA0209

E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
La velocità del supporto non è compatibile con il dispositivo. Ciò può essere causato dall'uso di supporti di velocità superiori o inferiori rispetto all'intervallo di velocità supportato dal dispositivo.

Valore: 0xC0AA020F

HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
L'handle specificato non è valido.

Valore: 6

HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
La risorsa di rete o il dispositivo specificato non sono più disponibili.

Valore: 55

E_IMAPI_RECORDER_LOCKED
Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'esito negativo di questa operazione.

Valore: 0xC0AA0210

E_IMAPI_ERASE_MEDIA_IS_NOT_SUPPORTED
Il tipo di supporto corrente non è supportato.

Valore: 0xC0AA0909

E_IMAPI_ERASE_DRIVE_FAILED_SPINUP_COMMAND
L'unità ha restituito un errore per un comando START UNIT (spinup). Potrebbe essere necessario un intervento manuale.

Valore: 0x80AA0908

E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR
L'unità non ha completato la cancellazione in un'ora. L'unità può richiedere un ciclo di alimentazione, una rimozione di supporti o un altro intervento manuale per riprendere il corretto funzionamento.
Nota Attualmente, questo valore verrà restituito anche se un tentativo di eseguire una cancellazione su supporti CD-RW o DVD-RW tramite l'interfaccia IDiscFormat2Erase ha esito negativo a causa dell'errore del supporto.
 
Valore: 0x80AA0906

Commenti

Cancella in modo sincrono i supporti. È possibile segnalare lo stato di avanzamento chiamando gli eventi registrati di tipo DDiscFormat2EraseEvents.

Prima di chiamare questo metodo, è necessario chiamare i metodi seguenti:

È anche consigliabile chiamare il metodo IDiscFormat2Erase::p ut_FullErase se il valore predefinito non è appropriato per l'applicazione.

Questo metodo è asincrono. Per determinare lo stato di avanzamento dell'operazione di cancellazione, è necessario implementare l'interfaccia DDiscFormat2EraseEvents . Per esempi che illustrano come implementare un gestore eventi in uno script, vedere Monitoraggio dello stato di avanzamento con eventi.

Attualmente, il valore E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR viene restituito se un tentativo di eseguire una cancellazione nei supporti CD-RW o DVD-RW tramite l'interfaccia IDiscFormat2Erase ha esito negativo in seguito all'errore del supporto o a un errore di unità.

Requisiti

   
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione imapi2.h

Vedi anche

IDiscFormat2Erase

IDiscFormat2Erase::get_FullErase

IDiscFormat2Erase::p ut_FullErase