Interfaz IDiscRecorder (imapi.h)
La interfaz IDiscRecorder permite el acceso a un único dispositivo de grabadora de discos, con la etiqueta de la grabadora de discos activa. Un objeto IMAPI, como MSDiscMasterObj , mantiene una grabadora de discos activa.
Un objeto IDiscRecorder representa un único dispositivo de hardware, pero puede haber varias instancias de IDiscRecorder que hacen referencia al mismo dispositivo de hardware. En este caso, use OpenExclusive para acceder a ese dispositivo.
Herencia
La interfaz IDiscRecorder hereda de la interfaz IUnknown . IDiscRecorder también tiene estos tipos de miembros:
Métodos
La interfaz IDiscRecorder tiene estos métodos.
| IDiscRecorder::Close Libera acceso exclusivo a una grabadora de discos. Esto restaura el acceso del sistema de archivos a la unidad. |
| IDiscRecorder::Eject Desbloquea y expulsa la bandeja de la grabadora de discos, si es posible. |
| IDiscRecorder::Erase Intenta borrar el medio CD-RW si se trata de una grabadora de discos CD-RW. Se admiten borrados completos y rápidos. |
| IDiscRecorder::GetBasePnPID Recupera una cadena PnP base que se puede usar para identificar de forma coherente una clase específica de dispositivo por marca y modelo. Las aplicaciones pueden usar la cadena para personalizar su comportamiento según el tipo de grabadora específico. |
| IDiscRecorder::GetDisplayNames Recupera un nombre con formato para la grabadora que se puede mostrar. El nombre consta del fabricante y el identificador de producto del dispositivo. |
| IDiscRecorder::GetPath Recupera una ruta de acceso al dispositivo dentro del sistema operativo. Esta ruta de acceso debe usarse junto con el nombre para mostrar para identificar completamente una grabadora de disco disponible. |
| IDiscRecorder::GetRecorderGUID Recupera el GUID de la grabadora de disco físico asociada actualmente con el objeto recorder. |
| IDiscRecorder::GetRecorderProperties Recupera un puntero a una interfaz IPropertyStorage. |
| IDiscRecorder::GetRecorderState Recupera el estado de la grabadora de discos. |
| IDiscRecorder::GetRecorderType Determina si la grabadora de discos es un dispositivo de tipo CD-R o CD-RW. Esto no indica el tipo de medio que se inserta actualmente en el dispositivo. |
| IDiscRecorder::OpenExclusive Abre una grabadora de disco para acceso exclusivo. |
| IDiscRecorder::QueryMediaInfo Recupera información sobre los medios montados actualmente, como el número total de bloques usados en el medio. |
| IDiscRecorder::QueryMediaType Detecta el tipo de medio insertado actualmente en la grabadora, si existe. |
| IDiscRecorder::SetRecorderProperties Acepta un puntero IPropertyStorage para un objeto con todas las propiedades que la aplicación desea cambiar. Se admite la configuración dispersa. |
Comentarios
Todas las interfaces IDiscRecorder se pueden usar en un objeto IDiscRecorder incluso si la grabadora de discos no es la grabadora de disco activa. El cliente IMAPI no tiene que llamar primero a IDiscMaster::SetActiveDiscRecorder .
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | imapi.h |