Interface IDiscRecorder (imapi.h)
A interface IDiscRecorder permite o acesso a um único dispositivo gravador de disco, rotulado como gravador de disco ativo. Um objeto IMAPI, como MSDiscMasterObj , mantém um gravador de disco ativo.
Um objeto IDiscRecorder representa um único dispositivo de hardware, mas pode haver várias instâncias de IDiscRecorder referenciando o mesmo dispositivo de hardware. Nesse caso, use OpenExclusive para acessar esse dispositivo.
Herança
A interface IDiscRecorder herda da interface IUnknown . IDiscRecorder também tem estes tipos de membros:
Métodos
A interface IDiscRecorder tem esses métodos.
| IDiscRecorder::Close Libera o acesso exclusivo a um gravador de disco. Isso restaura o acesso do sistema de arquivos à unidade. |
| IDiscRecorder::Ejetar Desbloqueia e ejeta a bandeja do gravador de disco, se possível. |
| IDiscRecorder::Erase Tenta apagar a mídia CD-RW se este for um gravador de disco CD-RW. Há suporte para erases completas e rápidas. |
| IDiscRecorder::GetBasePnPID Recupera uma cadeia de caracteres PnP base que pode ser usada para identificar consistentemente uma classe específica de dispositivo por modelo e make. A cadeia de caracteres pode ser usada por aplicativos para personalizar seu comportamento de acordo com o tipo de gravador específico. |
| IDiscRecorder::GetDisplayNames Recupera um nome formatado para o gravador que pode ser exibido. O nome consiste no fabricante e no identificador do produto do dispositivo. |
| IDiscRecorder::GetPath Recupera um caminho para o dispositivo dentro do sistema operacional. Esse caminho deve ser usado em conjunto com o nome de exibição para identificar completamente um gravador de disco disponível. |
| IDiscRecorder::GetRecorderGUID Recupera o GUID do gravador de disco físico atualmente associado ao objeto gravador. |
| IDiscRecorder::GetRecorderProperties Recupera um ponteiro para uma interface IPropertyStorage. |
| IDiscRecorder::GetRecorderState Recupera o estado do gravador de disco. |
| IDiscRecorder::GetRecorderType Determina se o gravador de disco é um dispositivo do tipo CD-R ou CD-RW. Isso não indica o tipo de mídia que está atualmente inserida no dispositivo. |
| IDiscRecorder::OpenExclusive Abre um gravador de disco para acesso exclusivo. |
| IDiscRecorder::QueryMediaInfo Recupera informações sobre a mídia montada no momento, como o número total de blocos usados na mídia. |
| IDiscRecorder::QueryMediaType Detecta o tipo de mídia atualmente inserido no gravador, se houver. |
| IDiscRecorder::SetRecorderProperties Aceita um ponteiro IPropertyStorage para um objeto com todas as propriedades que o aplicativo deseja alterar. Há suporte para configurações esparsas. |
Comentários
Todas as interfaces IDiscRecorder podem ser usadas em um objeto IDiscRecorder mesmo que o gravador de discos não seja o gravador de disco ativo. O cliente IMAPI não precisa chamar IDiscMaster::SetActiveDiscRecorder primeiro.
Requisitos
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi.h |