Partager via

À propos de l’API De mastering d’images

  • Article

Cette documentation se concentre sur une description de l’implémentation adaptec d’IMAPI pour Microsoft (IMAPIv1). Par conséquent, les descriptions des quatre objets COM main et de leurs interfaces sont incluses dans ce document. Les quatre objets main sont les suivants : MSDiscMasterObj, MSDiscRecorderObj, MSDiscStashObj et MSBurnEngineObj.

Plusieurs objets MSDiscMasterObj peuvent être instanciés sur un système, mais une seule application peut accéder à un enregistreur à la fois. MSDiscMasterObj implémente plusieurs interfaces, comme illustré dans le diagramme d’objets suivant.

msdiscmasterobj implémente plusieurs interfaces

Les applications utilisent l’interface IDiscMaster pour effectuer les tâches suivantes :

  • Ouvrir IMAPI
  • Énumérer les formats pris en charge (Joliet et Redbook)
  • Sélectionner un format
  • Obtenir la liste des enregistreurs
  • Sélectionner un enregistreur
  • Démarrer une gravure

Les interfaces IJolietDiscMaster et IRedbookDiscMaster sont retournées à une application via l’interface IDiscMaster lorsqu’un format est sélectionné. Ces interfaces contrôlent respectivement le contenu d’un disque de données ou d’un disque audio. Il n’est pas prévu que chaque application comprenne les interfaces de format spécifiques. Les applications peuvent accéder aux propriétés génériques de l’interface IJolietDiscMaster , telles que le nom du volume ou le nom de fichier hérité.

Les objets MSDiscRecorderObj sont accessibles via l’interface IDiscRecorder. Chaque appareil CD-R ou CD-RW compatible avec IMAPI a un objet MSDiscRecorderObj correspondant. Une application utilise des pointeurs vers l’interface IDiscRecorder sur ces objets pour sélectionner l’appareil qui sera utilisé par IMAPI pour enregistrer un CD. En outre, les applications peuvent accéder aux propriétés génériques d’un enregistreur via IDiscRecorder. Cela inclut des propriétés telles que la vitesse de l’enregistreur ou d’autres paramètres de gravure.

Les objets restants, MSDiscStashObj et MSBurnEngineObj, sont des objets internes accessibles par IMAPI. Ils sont mentionnés ici uniquement pour clarifier l’architecture IMAPI. MSDiscStashObj représente (via l’interface IDiscStash) un fichier brut d’une taille maximale de 800 Mo utilisé par MSDiscMasterObj pour créer des images audio ou des disques de données à graver. La mémoire est transmise à MSBurnEngineObj (via l’interface IMSBurnEngine ) lorsqu’une gravure est demandée à partir du moteur de niveau inférieur. L’objet MSBurnEngineObj s’attend à ce que le contenu de la mémoire soit dans un format connu. À cet égard, MSDiscMasterObj et MSBurnEngineObj ont un contrat concernant le contenu de la cache.