Metodo IDiscFormat2TrackAtOnce::CancelAddTrack (imapi2.h)
Annulla l'operazione di scrittura corrente.
Sintassi
HRESULT CancelAddTrack();
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 |
|---|---|
|
Non è attualmente in corso alcuna operazione di scrittura.
Valore: 0xC0AA0501 |
|
Errore non specificato.
Valore: 0x80004005 |
Commenti
Per annullare l'operazione di scrittura, è necessario chiamare questo metodo dal gestore eventi DDiscFormat2TrackAtOnceEvents::Update implementato.
È inoltre necessario chiamare il metodo IDiscFormat2TrackAtOnce::ReleaseMedia dopo aver chiamato questo metodo.
Si noti che la chiamata a questo metodo non annulla immediatamente l'operazione di scrittura su tutti i supporti a causa di requisiti specifici del supporto. Ad esempio, quando si scrive in un CD, l'operazione di scrittura può continuare per un massimo di tre minuti.
Questo metodo può comportare la registrazione di una traccia audio parziale. Il metodo tenterà di mantenere il supporto in uno stato utilizzabile e tratterà semplicemente la traccia annullata come più breve di quanto descritto originariamente da IStream. I chiamanti devono eseguire una query sul numero di tracce e dimensioni di traccia dopo l'annullamento per determinare lo stato del disco.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |