Método IDiscFormat2RawCD::SetWriteSpeed (imapi2.h)
Establece la velocidad de escritura de la grabadora de discos.
Sintaxis
HRESULT SetWriteSpeed(
[in] LONG RequestedSectorsPerSecond,
[in] VARIANT_BOOL RotationTypeIsPureCAV
);
Parámetros
[in] RequestedSectorsPerSecond
Velocidad de escritura solicitada medida en sectores de disco por segundo.
Un valor de 0xFFFFFFFF (-1) solicita que la escritura se produzca con la velocidad admitida más rápida para el medio. Este es el valor predeterminado.
[in] RotationTypeIsPureCAV
Tipo de control de velocidad rotacional solicitado. Establézcalo en VARIANT_TRUE para solicitar el tipo de control de velocidad angular constante (CAV). Establézcalo en VARIANT_FALSE para usar otro tipo de control de velocidad rotacional compatible con la grabadora. El valor predeterminado es VARIANT_FALSE.
Valor devuelto
S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
| Código devuelto | Descripción |
|---|---|
|
La solicitud requiere que se seleccione una grabadora de disco actual.
Valor: 0xC0AA0003 |
|
Uno o varios argumentos no son válidos.
Valor: 0x80070057 |
|
El puntero no es válido.
Valor: 0x80004003 |
|
Error no especificado.
Valor: 0x80004005 |
|
No se pudo asignar la memoria necesaria.
Valor: 0x8007000E |
|
El dispositivo no pudo aceptar el comando dentro del período de tiempo de espera. Esto puede deberse a que el dispositivo ha entrado en un estado incoherente o puede que sea necesario aumentar el valor de tiempo de espera del comando.
Valor: 0xC0AA020D |
|
El dispositivo notificó datos inesperados o no válidos para un comando.
Valor: 0xC0AA02FF |
|
El medio se inserta al revés.
Valor: 0xC0AA0204 |
|
La unidad informó de que está en proceso de preparación. Vuelva a intentar la solicitud más tarde.
Valor: 0xC0AA0205 |
|
No hay ningún medio en el dispositivo.
Valor: 0xC0AA0202 |
|
El medio está siendo formateado actualmente. Espere a que se complete el formato antes de intentar usar el medio.
Valor: 0xC0AA0206 |
|
La unidad informó de que está realizando una operación de larga duración, como finalizar una escritura. La unidad puede no ser utilizable durante un largo período de tiempo.
Valor: 0xC0AA0207 |
|
Error de escritura porque la unidad no recibió datos lo suficientemente rápido como para continuar escribiendo. Mover los datos de origen al equipo local, reducir la velocidad de escritura o habilitar una configuración de "búfer bajo ejecución libre" puede resolver este problema.
Valor: 0xC0AA0300 |
|
El medio no es compatible o con un formato físico desconocido.
Valor: 0xC0AA0203 |
|
La estructura de DVD no está presente. Esto puede deberse a que se usa una unidad o un medio incompatibles.
Valor: 0xC0AA020E |
|
El dispositivo informó de que la página de modo solicitado (y tipo) no está presente.
Valor: 0xC0AA0201 |
|
La unidad informó de que no se admitía la combinación de parámetros proporcionados en la página de modo para un comando MODE SELECT.
Valor: 0xC0AA0208 |
|
La unidad informó de que el medio está protegido por escritura.
Valor: 0xC0AA0209 |
|
La velocidad del medio no es compatible con el dispositivo. Esto puede deberse al uso de medios de mayor o menor velocidad que el intervalo de velocidades compatibles con el dispositivo.
Valor: 0xC0AA020F |
|
El identificador especificado no es válido.
Valor: 6 |
|
El recurso de red o el dispositivo especificados ya no se encuentran disponibles.
Valor: 55 |
|
El dispositivo asociado a esta grabadora durante la última operación se ha bloqueado exclusivamente, lo que provoca un error en esta operación.
Valor: 0xC0AA0210 |
|
Solo se admiten medios CD-R/RW en blanco.
Valor: 0xC0AA0606 |
|
Solo se admiten medios CD-R/RW en blanco.
Valor: 0xC0AA0607 |
|
El nombre de cliente no es válido.
Valor: 0xC0AA0604 |
|
El tipo de rotación solicitado no era compatible con la unidad y se ajustaba el tipo de rotación.
Valor: 0x00AA0005 |
|
La velocidad de escritura solicitada no era compatible con la unidad y la velocidad se ajustaba.
Valor: 0x00AA0004 |
|
La velocidad de escritura solicitada y el tipo de rotación no fueron compatibles con la unidad y ambos se ajustaron.
Valor: 0x00AA0006 |
Comentarios
Este método establece la velocidad de escritura y el tipo de control de velocidad rotacional para una grabadora. Los valores solicitados pueden diferir de los valores establecidos en la grabadora. Para especificar la grabadora, llame al método IDiscFormat2RawCD::p ut_Recorder .
Si la grabadora admite la velocidad de escritura solicitada, el dispositivo de disco usa el valor solicitado. Si la grabadora no admite la velocidad de escritura solicitada, la grabadora usa una velocidad de escritura que admite que sea más cercana al valor solicitado. La propiedad IDiscFormat2RawCD::get_CurrentWriteSpeed contiene el valor usado por la grabadora.
Para recuperar una lista de las velocidades de escritura que admite la grabadora y los medios actuales, llame al método IDiscFormat2RawCD::get_SupportedWriteSpeeds .
Si solicitas una velocidad angular constante (CAV) para el tipo de control de velocidad rotacional y la grabadora no admite CAV, el dispositivo de disco usa otro tipo de control de velocidad rotacional que admita. La propiedad IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV indica el valor usado por la grabadora.
Para recuperar los valores solicitados, llame a los métodos IDiscFormat2RawCD::get_RequestedWriteSpeed e IDiscFormat2RawCD::get_RequestedRotationTypeIsPureCAV .
Requisitos
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi2.h |
Consulte también
IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV
IDiscFormat2RawCD::get_RequestedRotationTypeIsPureCAV