Informationen zur Bildmaster-API
Diese Dokumentation konzentriert sich auf eine Beschreibung der Adaptec-Implementierung von IMAPI für Microsoft (IMAPIv1). Daher sind beschreibungen der vier Standard COM-Objekte und deren Schnittstellen in diesem Dokument enthalten. Die vier Standard-Objekte sind wie folgt: MSDiscMasterObj, MSDiscRecorderObj, MSDiscStashObj und MSBurnEngineObj.
Auf einem System können mehrere MSDiscMasterObj-Objekte instanziiert werden, aber nur eine Anwendung kann gleichzeitig auf einen Rekorder zugreifen. MsDiscMasterObj implementiert mehrere Schnittstellen, wie im folgenden Objektdiagramm dargestellt.
Anwendungen verwenden die IDiscMaster-Schnittstelle , um die folgenden Aufgaben auszuführen:
- Öffnen von IMAPI
- Auflisten unterstützter Formate (Joliet und Redbook)
- Format auswählen
- Abrufen einer Liste von Rekordern
- Auswählen eines Rekorders
- Starten eines Brennvorgangs
Die Schnittstellen IJolietDiscMaster und IRedbookDiscMaster werden über die IDiscMaster-Schnittstelle an eine Anwendung zurückgegeben, wenn ein Format ausgewählt wird. Diese Schnittstellen steuern den Inhalt eines Daten- oder Audiodatenträgers. Es wird nicht erwartet, dass jede Anwendung die spezifischen Formatschnittstellen versteht. Anwendungen können auf generische Eigenschaften der IJolietDiscMaster-Schnittstelle zugreifen, z. B. Volumename oder Legacydateiname.
Auf MSDiscRecorderObj-Objekte wird über die IDiscRecorder-Schnittstelle zugegriffen. Jedes CD-R- oder CD-RW-Gerät, das mit IMAPI kompatibel ist, verfügt über ein entsprechendes MSDiscRecorderObj-Objekt . Eine Anwendung verwendet Zeiger auf die IDiscRecorder-Schnittstelle für diese Objekte, um auszuwählen, welches Gerät von IMAPI zum Aufzeichnen einer CD verwendet wird. Darüber hinaus können Anwendungen über IDiscRecorder auf generische Eigenschaften eines Rekorders zugreifen. Dies umfasst Eigenschaften wie Die Schreibgeschwindigkeit oder andere Brennparameter.
Die restlichen Objekte , MSDiscStashObj und MSBurnEngineObj, sind interne Objekte, auf die von IMAPI zugegriffen wird. Sie werden hier nur erwähnt, um die IMAPI-Architektur zu verdeutlichen. Der MSDiscStashObj stellt (über die IDiscStash-Schnittstelle ) eine Rohdatei mit einer Größe von bis zu 800 MB dar, die von MSDiscMasterObj zum Erstellen von Audioimages oder zu brennenden Datendatenträgern verwendet wird. Der Stash wird an msBurnEngineObj (über die IMSBurnEngine-Schnittstelle ) übergeben, wenn ein Burn von der unteren Engine angefordert wird. Das MSBurnEngineObj-Objekt erwartet, dass der Inhalt des Stashs in einem bekannten Format vorliegt. In dieser Hinsicht haben MSDiscMasterObj und MSBurnEngineObj einen Vertrag über den Inhalt des Stashs.