Informazioni sull'API di mastering delle 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, MSDiscStashObje MSBurnEngineObj.
In un sistema possono essere presenti più oggetti MSDiscMasterObj, ma solo un'applicazione può accedere a un registratore alla volta. Il MSDiscMasterObj implementa più interfacce, come illustrato nel diagramma oggetti seguente.
Le applicazioni usano l'interfacciaIDiscMasterper 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 combustione
Le interfacce IJolietDiscMaster e IRedbookDiscMaster vengono restituite a un'applicazione tramite l'interfacciaIDiscMaster quando viene selezionato un formato. Queste interfacce controllano rispettivamente il contenuto di un disco audio o dati. 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 di file legacy.
Gli oggetti MSDiscRecorderObj sono accessibili tramite l'interfaccia IDiscRecorder. Ogni CD-R o CD-RW dispositivo compatibile con IMAPI dispone di un oggetto MSDiscRecorderObj corrispondente. Un'applicazione usa puntatori all'interfaccia IDiscRecorder su tali oggetti per selezionare il dispositivo che verrà usato da IMAPI per registrare un CD. Inoltre, le applicazioni possono accedere a proprietà generica di un registratore tramite IDiscRecorder. Sono incluse proprietà come la velocità del writer o altri parametri di burn.
Gli oggetti rimanenti, MSDiscStashObj e MSBurnEngineObj, sono oggetti interni a cui accede IMAPI. Sono menzionati qui solo per chiarire l'architettura IMAPI. Il MSDiscStashObj rappresenta (tramite l'interfaccia IDiscStash) un file non elaborato fino a 800 MB di dimensioni utilizzate da MSDiscMasterObj per creare immagini audio o dischi dati da masterizzare. Lo stash viene passato al MSBurnEngineObj (tramite l'interfaccia IMSBurnEngine) quando viene richiesta una masterizzazione dal motore di livello inferiore. L'oggetto MSBurnEngineObj prevede che il contenuto dello stash sia in un formato noto. A questo proposito, MSDiscMasterObj e MSBurnEngineObj hanno un contratto relativo al contenuto dello stash.