Método IVMRMonitorConfig::SetMonitor (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.]

Em um sistema de vários monitores, o SetMonitor método especifica o monitor que essa instância da VMR deve usar para reprodução de vídeo.

Sintaxe

HRESULT SetMonitor(
  [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_INVALIDARG
Argumento inválido.
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 qual driver DirectDraw deve ser usado ao se conectar a um filtro de decodificador upstream.

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

Requisito Valor
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::GetMonitor

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