Interagieren mit IMAPI

Die folgenden Schritte beschreiben eine typische Interaktion zwischen einer Anwendung und IMAPI.

1. Erstellen Sie eine instance des MSDiscMasterObj (mit CoCreateInstance, intelligenten Zeigern aus einem Import usw.), und fordern Sie die IDiscMaster-Schnittstelle an.
2. Erhalten Sie Zugriff auf IMAPI, indem Sie IDiscMaster::Open aufrufen. Wenn dieser Aufruf erfolgreich ist, hat die Anwendung Vollzugriff auf alle Schnittstellen und Methoden, die in MSDiscMasterObj implementiert sind.
3. Rufen Sie den Datenträger master Formatenumerator mithilfe von EnumDiscMasterFormats ab. Listet die Formate auf, die vom Datenträger master -Objekt unterstützt werden, und wählen Sie dann das aktive Format aus. Die vom Enumerator zurückgegebenen Formate sind die IIDs der Schnittstellen für IJolietDiscMaster und IRedbookDiscMaster.
4. Rufen Sie den Disc Recorder-Enumerator mithilfe von EnumDiscRecorders ab. Listen Sie die Liste der unterstützten Datenträgerrecorder auf (spezifisch für das aktive Format), und wählen Sie dann den aktiven Recorder aus. Die IDiscRecorder-Schnittstelle stellt ein physisches Gerät dar.
5. Verwenden Sie IDiscMaster::P rogressAdvise , um sich für Statusrückrufe zu registrieren.
6. Verwenden Sie die Schnittstelle für das ausgewählte Format, um Inhalte zu erstellen. Inhalte werden inkrementell erstellt, sodass Titel oder Ordnerinhalte stückweise einem Datenträger hinzugefügt werden können. Das Erstellen dieses Inhalts wird als Staging eines Images bezeichnet. Der Inhalt des mehrstufigen Bilds kann nicht inkrementell gelöscht werden (Sie können keine hinzugefügte Spur entfernen), aber es ist möglich, den Inhalt eines mehrstufigen Bilds zu löschen, damit die Stagingerstellung erneut gestartet werden kann. Verwenden Sie IDiscMaster::ClearFormatContent , um das Staging neu zu starten.

**Für Audio: **

1. Verwenden Sie IRedbookDiscMaster::CreateAudioTrack , um anzugeben, dass eine neue Audiospur auf dem Datenträger gestartet wird.
2. Verwenden Sie IRedbookDiscMaster::AddAudioTrackBlocks , um einer Spur rohe Audiodaten hinzuzufügen. Die Anwendung kann GetAvailableAudioTrackBlocks, GetTotalAudioBlocks und GetUsedAudioBlocks verwenden, um statistische Informationen abzurufen.
3. Verwenden Sie IRedbookDiscMaster::CloseAudioTrack , um eine Audiospur zu schließen.
4. Wiederholen Sie die Schritte 1 bis 3, bis kein Leerzeichen vorhanden ist oder alle Audiospuren geschrieben wurden.

**Für Daten: **

1. Verwenden Sie IJolietDiscMaster::AddData , um dem Bild den Inhalt eines Ordners hinzuzufügen. Die Elemente in einem Ordner werden im Stammverzeichnis der Imagedatei platziert. Verwenden Sie GetTotalDataBlocks und GetUsedDataBlocks , um statistische Informationen abzurufen.
2. Wiederholen Sie den obigen Schritt, bis der Speicherplatz nicht mehr vorhanden ist oder alle Daten hinzugefügt wurden.

**Für alle Datenträger: **

1. Verwenden Sie IDiscMaster::RecordDisc , um den Datenträger aufzuzeichnen.
2. Schließen Sie die IMAPI-Sitzung mit IDiscMaster::Close. Beim Schließen der Sitzung wird der Inhalt des Datenträgerstashs gelöscht.