Informazioni sull'API Mastering immagini
Questa documentazione è incentrata su una descrizione dell'implementazione adaptec di IMAPI per Microsoft (IMAPIv1). Di conseguenza, le descrizioni dei quattro oggetti COM principali e delle relative interfacce sono incluse in questo documento. I quattro oggetti principali sono i seguenti: MSDiscMasterObj, MSDiscRecorderObj, MSDiscStashObj e MSBurnEngineObj.
È possibile creare un'istanza di più oggetti MSDiscMasterObj in un sistema, ma solo un'applicazione può accedere a un registratore alla volta. MSDiscMasterObj implementa più interfacce, come illustrato nel diagramma di oggetti seguente.
Le applicazioni usano l'interfaccia IDiscMaster per eseguire le attività seguenti:
- Aprire IMAPI
- Enumerare i formati supportati (Joliet e Redbook)
- Selezionare un formato
- Ottenere un elenco di registratori
- Selezionare un registratore
- Avviare una bruciatura
Le interfacce IJolietDiscMaster e IRedbookDiscMaster vengono restituite a un'applicazione tramite l'interfaccia IDiscMaster quando viene selezionato un formato. Queste interfacce controllano rispettivamente il contenuto di un disco dati o audio. Non è previsto che ogni applicazione comprenda le interfacce di formato specifiche. Le applicazioni possono accedere alle proprietà generiche dell'interfaccia IJolietDiscMaster , ad esempio il nome del volume o il nome del file legacy.
Gli oggetti MSDiscRecorderObj vengono accessibili tramite l'interfaccia IDiscRecorder. Ogni dispositivo CD-R o CD-RW compatibile con IMAPI ha un oggetto MSDiscRecorderObj corrispondente. Un'applicazione usa puntatori all'interfaccia IDiscRecorder su tali oggetti per selezionare quale dispositivo verrà usato da IMAPI per registrare un CD. Inoltre, le applicazioni possono accedere alle proprietà generice di un registratore tramite IDiscRecorder. Sono incluse proprietà come velocità del writer o altri parametri di burn.
Gli oggetti rimanenti, MSDiscStashObj e MSBurnEngineObj, sono oggetti interni accessibili da IMAPI. Sono menzionati qui solo per chiarire l'architettura IMAPI. MSDiscStashObj rappresenta (tramite l'interfaccia IDiscStash) un file non elaborato fino a 800 MB di dimensioni usate da MSDiscMasterObj per creare immagini audio o dischi dati da masterizzare. Lo stash viene passato a MSBurnEngineObj (tramite l'interfaccia IMSBurnEngine ) quando viene richiesta una combustione dal motore di livello inferiore. L'oggetto MSBurnEngineObj prevede che il contenuto dello stash sia in un formato noto. In questo senso, MSDiscMasterObj e MSBurnEngineObj hanno un contratto relativo al contenuto dello stash.