Método IDiscMaster::EnumDiscRecorders (imapi.h)
Recupera un enumerador para todas las grabadoras de discos compatibles con el formato maestro de disco activo.
Sintaxis
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
Parámetros
[out] ppEnum
Dirección de un puntero al enumerador IEnumDiscRecorders .
Valor devuelto
S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:
Comentarios
IEnumDiscRecorders es un enumerador COM estándar, tal como se documenta en IEnumXXXX. Cada llamada a Next devuelve una matriz de punteros a IDiscRecorder. Cada interfaz de grabadora representa una sola grabadora disponible ya asociada a una grabadora de disco físico subyacente.
La lista de grabadoras disponibles puede cambiar debido a las llegadas o salidas de Plug and Play, o a una llamada a SetActiveDiscMasterFormat. Se notifica a una aplicación estos cambios cuando recibe una llamada a IDiscMasterProgressEvents::NotifyPnPActivity. Cuando se produce un cambio, la aplicación debe llamar a este método de nuevo para recuperar un nuevo enumerador, ya que cada enumerador contiene una instantánea de los dispositivos admitidos en el momento de la enumeración.
Cuando se quita un dispositivo, su puntero y la interfaz IDiscRecorder deben permanecer válidas aunque falte el dispositivo físico subyacente. En este caso, las operaciones en un IDiscRecorder o una solicitud para grabar un disco pueden devolver IMAPI_E_DEVICE_NOTPRESENT.
La propiedad MaxWriteSpeed se actualiza cuando se llama a este método. La configuración predeterminada es la velocidad de escritura más alta disponible.
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 |
| Library | Uuid.lib |
| Archivo DLL | Actxprxy.dll |