Compartilhar via

Sobre a API de Masterização de Imagens

  • Artigo

Esta documentação se concentra em uma descrição da implementação Adaptec do IMAPI para Microsoft (IMAPIv1). Dessa forma, as descrições dos quatro objetos COM main e suas interfaces estão incluídas neste documento. Os quatro objetos main são os seguintes: MSDiscMasterObj, MSDiscRecorderObj, MSDiscStashObj e MSBurnEngineObj.

Pode haver vários objetos MSDiscMasterObj instanciados em um sistema, mas apenas um aplicativo pode acessar um gravador por vez. O MSDiscMasterObj implementa várias interfaces, conforme mostrado no diagrama de objeto a seguir.

o msdiscmasterobj implementa várias interfaces

Os aplicativos usam a interface IDiscMaster para executar as seguintes tarefas:

  • Abrir IMAPI
  • Enumerar formatos com suporte (Joliet e Redbook)
  • Selecionar um formato
  • Obter uma lista de gravadores
  • Selecionar um gravador
  • Iniciar uma queima

As interfaces IJolietDiscMaster e IRedbookDiscMaster são retornadas a um aplicativo por meio da interface IDiscMaster quando um formato é selecionado. Essas interfaces controlam o conteúdo de um disco de dados ou áudio, respectivamente. Não é esperado que todos os aplicativos entendam as interfaces de formato específicas. Os aplicativos podem acessar propriedades genéricas da interface IJolietDiscMaster , como nome do volume ou nome de arquivo herdado.

Os objetos MSDiscRecorderObj são acessados por meio da interface IDiscRecorder. Cada dispositivo CD-R ou CD-RW compatível com IMAPI tem um objeto MSDiscRecorderObj correspondente. Um aplicativo usa ponteiros para a interface IDiscRecorder nesses objetos para selecionar qual dispositivo será usado pelo IMAPI para gravar um CD. Além disso, os aplicativos podem acessar propriedades genéricas de um gravador por meio de IDiscRecorder. Isso inclui propriedades como velocidade do gravador ou outros parâmetros de gravação.

Os objetos restantes, MSDiscStashObj e MSBurnEngineObj, são objetos internos acessados pelo IMAPI. Eles são mencionados aqui apenas para esclarecer a arquitetura IMAPI. O MSDiscStashObj representa (por meio da interface IDiscStash ) um arquivo bruto de até 800 MB de tamanho usado pelo MSDiscMasterObj para criar imagens de áudio ou discos de dados a serem queimados. O stash é passado para o MSBurnEngineObj (por meio da interface IMSBurnEngine ) quando uma gravação é solicitada do mecanismo de nível inferior. O objeto MSBurnEngineObj espera que o conteúdo do stash esteja em um formato conhecido. Nesse sentido, MSDiscMasterObj e MSBurnEngineObj têm um contrato sobre o conteúdo do stash.