Método IDiscMaster::EnumDiscRecorders (imapi.h)
Recupera um enumerador para todos os gravadores de disco compatíveis com o formato de master de disco ativo.
Sintaxe
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
Parâmetros
[out] ppEnum
Endereço de um ponteiro para o enumerador IEnumDiscRecorders .
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
IEnumDiscRecorders é um enumerador COM padrão, conforme documentado em IEnumXXXX. Cada chamada para Next retorna uma matriz de ponteiros para IDiscRecorder. Cada interface de gravador representa um único gravador disponível já associado a um gravador de disco físico subjacente.
A lista de gravadores disponíveis pode ser alterada devido a chegadas ou saídas do Plug and Play ou a uma chamada para SetActiveDiscMasterFormat. Um aplicativo é notificado sobre essas alterações quando recebe uma chamada para IDiscMasterProgressEvents::NotifyPnPActivity. Quando ocorre uma alteração, o aplicativo deve chamar esse método novamente para recuperar um novo enumerador, pois cada enumerador contém uma instantâneo dos dispositivos com suporte no momento da enumeração.
Quando um dispositivo é removido, seu ponteiro e a interface IDiscRecorder devem permanecer válidos mesmo que o dispositivo físico subjacente esteja ausente. Nesse caso, as operações em um IDiscRecorder ou uma solicitação para gravar um disco podem retornar IMAPI_E_DEVICE_NOTPRESENT.
A propriedade MaxWriteSpeed é atualizada quando esse método é chamado. A configuração padrão é a velocidade de gravação mais alta disponível.
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 |
| Biblioteca | Uuid.lib |
| DLL | Actxprxy.dll |