Interfaz IWriteEngine2 (imapi2.h)
Use esta interfaz para escribir un flujo de datos en un dispositivo.
Estas interfaces deben usarse con aquellos que desarrollan compatibilidad con nuevos tipos de medios o formatos. Escribir en medios normalmente incluye los pasos siguientes:
- Preparar el hardware estableciendo páginas de modo para el medio.
- Consultar el hardware para comprobar que el medio es lo suficientemente grande.
- Inicializar la escritura, por ejemplo, al dar formato a los medios o establecer OPC.
- Realización de los comandos WRITE reales.
- Para finalizar la escritura, detenga el formato o cierre la sesión o el seguimiento.
La mayoría de las aplicaciones cliente deben usar la interfaz IDiscFormat2Data para escribir imágenes en un dispositivo.
Para crear una instancia de esta interfaz, llame a la función CoCreateInstance . Use__uuidof(MsftWriteEngine2) para el identificador de clase y __uuidof(IWriteEngine2) para el identificador de interfaz.
Herencia
La interfaz IWriteEngine2 hereda de la interfaz IDispatch . IWriteEngine2 también tiene estos tipos de miembros:
Métodos
La interfaz IWriteEngine2 tiene estos métodos.
| IWriteEngine2::CancelWrite Cancela una operación de escritura que está en curso. |
| IWriteEngine2::get_BytesPerSector Recupera el número de bytes que se van a usar para cada sector durante la escritura. El valor devuelto indica cuál es el valor establecido previamente con IWriteEngine2::p ut_BytesPerSector y no devuelve un valor actual por sector para los medios. |
| IWriteEngine2::get_EndingSectorsPerSecond Recupera el número estimado de sectores por segundo que el dispositivo de grabación puede escribir en el medio al final del proceso de escritura. |
| IWriteEngine2::get_Recorder Recupera el dispositivo de grabación que se va a usar en la operación de escritura. |
| IWriteEngine2::get_StartingSectorsPerSecond Recupera el número estimado de sectores por segundo que el dispositivo de grabación puede escribir en el medio al principio del proceso de escritura. |
| IWriteEngine2::get_UseStreamingWrite12 Recupera un valor que indica si las operaciones de escritura usan el comando WRITE12 o WRITE10. |
| IWriteEngine2::get_WriteInProgress Recupera un valor que indica si la grabadora está escribiendo datos actualmente en el disco. |
| IWriteEngine2::p ut_BytesPerSector Establece el número de bytes que se van a usar para cada sector durante la escritura. |
| IWriteEngine2::p ut_EndingSectorsPerSecond Establece el número estimado de sectores por segundo que el dispositivo de grabación puede escribir en el medio al final del proceso de escritura. |
| IWriteEngine2::p ut_Recorder Establece un dispositivo de grabación para la operación de escritura. |
| IWriteEngine2::p ut_StartingSectorsPerSecond Establece el número estimado de sectores por segundo que el dispositivo de grabación puede escribir en el medio al principio del proceso de escritura. |
| IWriteEngine2::p ut_UseStreamingWrite12 Establece un valor que indica si las operaciones de escritura usan el comando WRITE12 o WRITE10. |
| IWriteEngine2::WriteSection Escribe un flujo de datos en la grabadora actual. |
Comentarios
Para crear el objeto MsftWriteEngine2 en un script, use IMAPI2. MsftWriteEngine2 como identificador de programa al llamar a CreateObject.
Es posible que se produzca una transición de estado de energía durante una operación de grabación (es decir, cierre de sesión del usuario o suspensión del sistema), lo que conduce a la interrupción del proceso de quema y la posible pérdida de datos. Para conocer las consideraciones de programación, vea Impedir inicio de sesión o suspender durante una grabación.
Requisitos
| Requisito | Value |
|---|---|
| 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 |