Metodo IDiscFormat2Data::SetWriteSpeed (imapi2.h)

Articolo
08/24/2023

Imposta la velocità di scrittura del registratore di dischi.

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 si verifica usando la velocità più veloce supportata per il supporto. Questo è il valore predefinito.

[in] RotationTypeIsPureCAV

Tipo di controllo rotazionale richiesto. Impostare su VARIANT_TRUE per richiedere il tipo di controllo a velocità di rotazione (CAV) costante. Impostare su VARIANT_FALSE per usare un altro tipo di controllo rotazionale a velocità supportata 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
E_IMAPI_RECORDER_REQUIRED	La richiesta richiede che sia selezionato un registratore di dischi corrente. Valore: 0xC0AA0003
E_INVALIDARG	Uno o più argomenti non sono validi. Valore: 0x80070057
E_POINTER	Puntatore non valido. Valore: 0x80004003
E_FAIL	Errore non specificato. Valore: 0x80004005
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	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
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 sottosopra. 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	Nel dispositivo non sono presenti supporti. 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 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
E_IMAPI_LOSS_OF_STREAMING	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
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Il supporto non è compatibile o di formato fisico sconosciuto. Valore: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	La struttura DVD non è presente. Ciò può essere causato da unità/media incompatibili usate. Valore: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	Il dispositivo ha segnalato che la pagina della 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. Questo 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 specificati 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'errore di questa operazione. Valore: 0xC0AA0210
E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE	La scrittura non è riuscita perché l'unità ha restituito informazioni sull'errore che non è stato possibile recuperare. Valore: 0xC0AA0301
S_IMAPI_ROTATIONADJUSTED	Il tipo di rotazione richiesto non è supportato dall'unità e il tipo di rotazione è stato modificato. Valore: 0x00AA0005
S_IMAPI_SPEEDADJUSTED	La velocità di scrittura richiesta non è supportata dall'unità e la velocità è stata modificata. Valore: 0x00AA0004
S_IMAPI_BOTHADJUSTED	La velocità di scrittura e il tipo di rotazione richiesti non sono stati supportati dall'unità e sono stati entrambi regolati. Valore: 0x00AA0006

Commenti

Questo metodo imposta la velocità di scrittura e il tipo di controllo rotazionale-velocità per un registratore. I valori richiesti potrebbero essere diversi dai valori impostati nel registratore. Per specificare il registratore, chiamare il metodo IDiscFormat2Data::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 usa una velocità di scrittura che supporta più vicina al valore richiesto. La proprietà IDiscFormat2Data::get_CurrentWriteSpeed contiene il valore utilizzato dal registratore.

Per recuperare un elenco delle velocità di scrittura supportate dal registratore e dai supporti correnti, chiamare il metodo IDiscFormat2Data::get_SupportedWriteSpeeds .

Se si richiede una velocità angolare costante (CAV) per il tipo di controllo rotazionale-velocità e il registratore non supporta CAV, il dispositivo disco usa un altro tipo di controllo rotazionale-velocità supportato. La proprietà IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV indica il valore utilizzato dal registratore.

Per recuperare i valori richiesti, chiamare i metodi IDiscFormat2Data::get_RequestedWriteSpeed e IDiscFormat2Data::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