Compartir a través de

Acerca de Image Mastering API

  • Artículo

Esta documentación se centra en una descripción de la implementación de Adaptec de IMAPI para Microsoft (IMAPIv1). Por lo tanto, en este documento se incluyen descripciones de los cuatro objetos COM principales y sus interfaces. Los cuatro objetos principales son los siguientes: MSDiscMasterObj, MSDiscRecorderObj, MSDiscStashObj y MSBurnEngineObj.

Puede haber varios objetos MSDiscMasterObj creados en una instancia en un sistema, pero solo una aplicación puede acceder a una grabadora a la vez. MSDiscMasterObj implementa varias interfaces, como se muestra en el diagrama de objetos siguiente.

msdiscmasterobj implementa varias interfaces

Las aplicaciones usan la interfaz IDiscMaster para realizar las tareas siguientes:

  • Abrir IMAPI
  • Enumerar los formatos admitidos (Copiet y Redbook)
  • Seleccionar un formato
  • Obtener una lista de grabadoras
  • Seleccionar una grabadora
  • Iniciar una quemadura

Las interfaces IJolietDiscMaster e IRedbookDiscMaster se devuelven a una aplicación a través de la interfaz IDiscMaster cuando se selecciona un formato. Estas interfaces controlan el contenido de un disco de audio o datos, respectivamente. No se espera que todas las aplicaciones comprendan las interfaces de formato específicas. Las aplicaciones pueden acceder a las propiedades genéricas de la interfaz IJolietDiscMaster , como el nombre del volumen o el nombre de archivo heredado.

Se accede a los objetos MSDiscRecorderObj a través de la interfaz IDiscRecorder. Cada dispositivo CD-R o CD-RW compatible con IMAPI tiene un objeto MSDiscRecorderObj correspondiente. Una aplicación usa punteros a la interfaz IDiscRecorder en esos objetos para seleccionar qué dispositivo usará IMAPI para grabar un CD. Además, las aplicaciones pueden acceder a las propiedades genéricas de una grabadora a través de IDiscRecorder. Esto incluye propiedades como velocidad de escritura u otros parámetros de grabación.

Los objetos restantes, MSDiscStashObj y MSBurnEngineObj, son objetos internos a los que accede IMAPI. Aquí solo se mencionan para aclarar la arquitectura imAPI. MSDiscStashObj representa (a través de la interfaz IDiscStash) un archivo sin formato de hasta 800 MB de tamaño que MSDiscMasterObj usa para crear imágenes de audio o discos de datos que se van a grabar. El stash se pasa al MSBurnEngineObj (a través de la interfaz IMSBurnEngine ) cuando se solicita una grabación desde el motor de nivel inferior. El objeto MSBurnEngineObj espera que el contenido del stash esté en un formato conocido. En este sentido, MSDiscMasterObj y MSBurnEngineObj tienen un contrato con respecto al contenido del stash.