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
E_FAIL
Não foi possível definir o monitor especificado como o padrão.
E_INVALIDARG
Argumento inválido. O monitor especificado não existe ou o parâmetro pGUID não foi formatado corretamente.
E_POINTER
Argumento de ponteiro NULL.
S_OK
Êxito.
VFW_E_WRONG_STATE
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

Confira também

Códigos de erro e êxito

IVMRMonitorConfig Interface

IVMRMonitorConfig::GetDefaultMonitor

Usando o Renderizador de Combinação de Vídeos