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 |
|---|---|
|
Argumento inválido. |
|
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 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 |