Metodo IDiscFormat2Data::Write (imapi2.h)
Scrive il flusso di dati nel dispositivo.
Sintassi
HRESULT Write(
[in] IStream *data
);
Parametri
[in] data
Interfaccia IStream del flusso di dati da scrivere.
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 |
|---|---|
|
Il dispositivo non è riuscito a accettare il comando entro il periodo di timeout. Questo può essere causato dal dispositivo che ha immesso uno stato incoerente o il valore di timeout per il comando potrebbe essere aumentato.
Valore: 0xC0AA020D |
|
Il dispositivo ha segnalato dati imprevisti o non validi per un comando.
Valore: 0xC0AA02FF |
|
Il supporto viene inserito sottosopra.
Valore: 0xC0AA0204 |
|
L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento.
Valore: 0xC0AA0205 |
|
Nel dispositivo non sono presenti supporti.
Valore: 0xC0AA0202 |
|
Il supporto è attualmente formattato. Attendere il completamento del formato prima di tentare di usare il supporto.
Valore: 0xC0AA0206 |
|
L'unità ha segnalato che esegue un'operazione a esecuzione prolungata, ad esempio il completamento di una scrittura. L'unità potrebbe non essere utilizzabile per un lungo periodo di tempo.
Valore: 0xC0AA0207 |
|
La scrittura non è riuscita perché l'unità non ha ricevuto i dati abbastanza rapidamente per continuare a scrivere. Lo spostamento dei dati di origine nel computer locale, la riduzione della velocità di scrittura o l'abilitazione di un'impostazione "buffer in esecuzione gratuita" può risolvere questo problema.
Valore: 0xC0AA0300 |
|
Il supporto non è compatibile o di formato fisico sconosciuto.
Valore: 0xC0AA0203 |
|
La struttura DVD non è presente. Ciò può essere causato da unità/media incompatibili usate.
Valore: 0xC0AA020E |
|
Il dispositivo ha segnalato che la pagina della modalità richiesta (e tipo) non è presente.
Valore: 0xC0AA0201 |
|
L'unità ha segnalato che la combinazione di parametri forniti nella pagina della modalità per un comando MODE SELECT non è supportata.
Valore: 0xC0AA0208 |
|
L'unità ha segnalato che il supporto è protetto da scrittura.
Valore: 0xC0AA0209 |
|
La velocità del supporto non è compatibile con il dispositivo. Questo può essere causato dall'uso di supporti di velocità superiori o inferiori rispetto all'intervallo di velocità supportato dal dispositivo.
Valore: 0xC0AA020F |
|
L'handle specificato non è valido.
Valore: 6 |
|
La risorsa di rete o il dispositivo specificati non sono più disponibili.
Valore: 55 |
|
Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'errore di questa operazione.
Valore: 0xC0AA0210 |
|
La scrittura non è riuscita perché l'unità ha restituito informazioni sull'errore che non è stato possibile recuperare.
Valore: 0xC0AA0301 |
|
La richiesta richiede che sia selezionato un registratore di dischi corrente.
Valore: 0xC0AA0003 |
|
Il tipo di rotazione richiesto non è supportato dall'unità e il tipo di rotazione è stato modificato.
Valore: 0x00AA0005 |
|
La velocità di scrittura richiesta non è supportata dall'unità e la velocità è stata modificata.
Valore: 0x00AA0004 |
|
La velocità di scrittura e il tipo di rotazione richiesti non sono stati supportati dall'unità e sono stati entrambi regolati.
Valore: 0x00AA0006 |
|
Questo dispositivo non supporta le operazioni richieste da questo formato disco.
Valore: 0xC0AA0407 |
|
La richiesta è stata annullata.
Valore: 0xC0AA0002 |
|
Attualmente è in corso un'operazione di scrittura.
Valore: 0xC0AA0400 |
|
Le dimensioni dell'oggetto IStream specificato non sono valide. Le dimensioni devono essere un multiplo delle dimensioni del settore, 2048.
Valore: 0xC0AA0403 |
|
Il tipo di supporto corrente non è supportato.
Valore: (HRESULT)0xC0AA0406 |
|
Uno o più argomenti non sono validi.
Valore: 0x80070057 |
|
Puntatore non valido.
Valore: 0x80004003 |
|
Errore non specificato.
Valore: 0x80004005 |
|
Impossibile allocare la memoria necessaria.
Valore: 0x8007000E |
|
Non implementato.
Valore: 0x80004001 |
Commenti
Prima di chiamare questo metodo, è necessario chiamare i metodi seguenti:
È anche consigliabile chiamare i metodi seguenti se i valori predefiniti non sono appropriati per l'applicazione:- IDiscFormat2Data::p ut_BufferUnderrunFreeDisabled
- IDiscFormat2Data::p ut_DisableConsumerDeviceCompatibilityMode
- IDiscFormat2Data::p ut_ForceMediaToBeClosed
- IDiscFormat2Data::p ut_ForceOverwrite
- IDiscFormat2Data::p ut_PostgapAlreadyInImage
- IDiscFormat2Data::SetWriteSpeed
Nei dischi registrati in sequenza, l'IStream fornito viene registrato come nuova sessione. Nei dischi riscrivibili, l'IStream fornito viene sempre registrato a partire dal settore 0, ma l'oggetto che fornisce l'interfaccia IStream può anche fornire l'interfaccia IBlockRangeList che elenca i settori che devono essere registrati. L'interfaccia IBlockRangeList viene usata per evitare di riscrivere i settori che non sono stati modificati negli scenari multisessione. Se l'oggetto che fornisce IStream non fornisce IBlockRangeList, si presuppone che l'intero IStream debba essere registrato.
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 |