Método IVMRMonitorConfig::SetDefaultMonitor (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O SetDefaultMonitor
método especifica o monitor padrão que todas as instâncias futuras da VMR devem usar para reprodução de vídeo.
Sintaxe
HRESULT SetDefaultMonitor(
[in] const VMRGUID *pGUID
);
Parâmetros
[in] pGUID
Ponteiro para uma estrutura VMRGUID que identifica o monitor.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.
Código de retorno | Descrição |
---|---|
|
Não foi possível definir o monitor especificado como o padrão. |
|
Argumento inválido. O monitor especificado não existe ou o parâmetro pGUID não foi formatado corretamente. |
|
Argumento de ponteiro NULL. |
|
Êxito. |
|
O alocador-apresentador não foi carregado. |
Comentários
Use esse método em um sistema de vários monitores para especificar para a VMR o dispositivo DirectDraw padrão a ser usado ao se conectar a um filtro de upstream. O dispositivo DirectDraw padrão pode ser substituído para uma conexão específica pelo método SetMonitor .
O membro pGUID da estrutura VMRGUID deve ser NULL, indicando o dispositivo DirectDraw padrão ou igual ao endereço do membro GUID da estrutura VMRGUID . Caso contrário, o método retornará E_INVALIDARG.
Se o GUID especificado não corresponder a nenhum monitor, o método retornará E_INVALIDARG.
Requisitos
Cliente mínimo com suporte | Windows XP com SP1 [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 | strmif.h (inclua Dshow.h) |
Biblioteca | Strmiids.lib |