Metodo IVMRMonitorConfig::SetMonitor (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

In un sistema multi-monitor, il SetMonitor metodo specifica il monitoraggio che questa istanza di VMR deve usare per la riproduzione video.

Sintassi

HRESULT SetMonitor(
  [in] const VMRGUID *pGUID
);

Parametri

[in] pGUID

Puntatore a una struttura VMRGUID che identifica il monitoraggio.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
E_INVALIDARG
Argomento non valido.
E_POINTER
Argomento puntatore NULL.
S_OK
Operazione completata.
VFW_E_WRONG_STATE
L'allocatore-relatore non è stato caricato.

Commenti

Usare questo metodo in un sistema multi-monitor per specificare la macchina virtuale che deve essere usata dal driver DirectDraw per la connessione a un filtro decodificatore upstream.

Il membro pGUID della struttura VMRGUID deve essere NULL, che indica il dispositivo DirectDraw predefinito o uguale all'indirizzo del membro GUID della struttura VMRGUID . In caso contrario, il metodo restituisce E_INVALIDARG.

Se il GUID specificato non corrisponde ad alcun monitoraggio, il metodo restituisce E_INVALIDARG.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP1 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IVMRMonitorConfig

IVMRMonitorConfig::GetMonitor

Uso del renderer di missaggio video