Método IDiscMaster::SetActiveDiscMasterFormat (imapi.h)
Define o formato de gravador de disco ativo no momento. O formato ativo especifica a estrutura do conteúdo do arquivo de imagem preparado (áudio/dados) e a interface COM que deve ser usada para manipular essa imagem preparada.
Sintaxe
HRESULT SetActiveDiscMasterFormat(
[in] REFIID riid,
[out] void **ppUnk
);
Parâmetros
[in] riid
IID do formato ativo no momento.
[out] ppUnk
Ponteiro para a interface COM para o novo formato de disco.
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 normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
Uma chamada bem-sucedida para esse método limpa o conteúdo da imagem em etapas no momento. Além disso, ele pode alterar a lista de gravadores de disco com suporte. Isso ocorre porque nem todos os gravadores dão suporte a todos os formatos. As alterações na lista de gravadores são anunciadas com IDiscMasterProgressEvents::NotifyPnPActivity. Se o gravador selecionado no momento não for membro do novo conjunto de dispositivos com suporte, não haverá mais um gravador ativo (semelhante ao estado após a primeira chamada para Abrir). Nesse caso, o aplicativo deve selecionar um novo gravador ativo antes de iniciar uma gravação.
O MSDiscMasterObj dá suporte apenas aos seguintes IIDs: IID_IRedbookDiscMaster (IRedbookDiscMaster) e IID_IJolietDiscMaster (IJolietDiscMaster). Se não houver nenhum formato definido, o padrão será o formato Joliet. É responsabilidade de cada aplicativo selecionar um formato master por meio do uso de EnumDiscMasterFormats e esse método.
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 |