Metodo IDiscFormat2TrackAtOnce::SetWriteSpeed (imapi2.h)
Imposta la velocità di scrittura del registratore del disco.
Sintassi
HRESULT SetWriteSpeed(
[in] LONG RequestedSectorsPerSecond,
[in] VARIANT_BOOL RotationTypeIsPureCAV
);
Parametri
[in] RequestedSectorsPerSecond
Velocità di scrittura richiesta misurata nei settori del disco al secondo.
Valore di 0xFFFFFFFF (-1) richieste che la scrittura viene eseguita usando la velocità supportata più veloce per il supporto. Questo è il valore predefinito.
[in] RotationTypeIsPureCAV
Tipo di controllo rotazionale richiesto. Impostare su VARIANT_TRUE per richiedere il tipo di controllo rotazionale a velocità angolare costante (CAV). Impostare su VARIANT_FALSE per usare un altro tipo di controllo di velocità rotazionale supportato dal registratore. Il valore predefinito è VARIANT_FALSE.
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 |
|---|---|
|
Per la richiesta è necessario selezionare un registratore di dischi corrente.
Valore: 0xC0AA0003 |
|
Uno o più argomenti non sono validi.
Valore: 0x80070057 |
|
Puntatore non valido.
Valore: 0x80004003 |
|
Errore non specificato.
Valore: 0x80004005 |
|
Impossibile allocare la memoria richiesta.
Valore: 0x8007000E |
|
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 |
|
Il dispositivo ha segnalato dati imprevisti o non validi per un comando.
Valore: 0xC0AA02FF |
|
Il supporto viene inserito a capovolto.
Valore: 0xC0AA0204 |
|
L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento.
Valore: 0xC0AA0205 |
|
Non sono presenti supporti nel dispositivo.
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 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 |
|
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 |
|
Il supporto non è compatibile o con un formato fisico sconosciuto.
Valore: 0xC0AA0203 |
|
La struttura DVD non è presente. Ciò può essere causato dall'uso di unità/supporto incompatibili.
Valore: 0xC0AA020E |
|
Il dispositivo ha segnalato che la pagina in 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. Ciò 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 specificato non sono più disponibili.
Valore: 55 |
|
Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'esito negativo di questa operazione.
Valore: 0xC0AA0210 |
|
La scrittura non è riuscita perché l'unità ha restituito informazioni sull'errore da cui non è stato possibile recuperare.
Valore: 0xC0AA0301 |
|
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 regolata.
Valore: 0x00AA0004 |
|
La velocità di scrittura e il tipo di rotazione richiesti non sono supportati dall'unità e sono stati entrambi regolati.
Valore: 0x00AA0006 |
Commenti
Questo metodo imposta la velocità di scrittura e il tipo di controllo rotazionale della velocità per un registratore. I valori richiesti possono essere diversi dai valori impostati nel registratore. Per specificare il registratore, chiamare il metodo IDiscFormat2TrackAtOnce::p ut_Recorder .
Se il registratore supporta la velocità di scrittura richiesta, il dispositivo disco usa il valore richiesto. Se il registratore non supporta la velocità di scrittura richiesta, il registratore utilizza una velocità di scrittura che supporta più vicino al valore richiesto. La proprietà IDiscFormat2TrackAtOnce::get_CurrentWriteSpeed contiene il valore utilizzato dal registratore.
Per recuperare un elenco delle velocità di scrittura supportate dal registratore e dal supporto corrente, chiamare il metodo IDiscFormat2TrackAtOnce::get_SupportedWriteSpeeds .
Se si richiede una velocità angolare costante (CAV) per il tipo di controllo rotazionale e il registratore non supporta CAV, il dispositivo disco utilizza un altro tipo di controllo rotazionale-velocità supportato. La proprietà IDiscFormat2TrackAtOnce::get_CurrentRotationTypeIsPureCAV indica il valore utilizzato dal registratore.
Per recuperare i valori richiesti, chiamare i metodi IDiscFormat2TrackAtOnce::get_RequestedWriteSpeed e IDiscFormat2TrackAtOnce::get_RequestedRotationTypeIsPureCAV .
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
IDiscFormat2TrackAtOnce::get_CurrentRotationTypeIsPureCAV
IDiscFormat2TrackAtOnce::get_RequestedRotationTypeIsPureCAV