Metodo IVMRFilterConfig::GetRenderingPrefs (strmif.h)

  • Articolo

[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.

Il GetRenderingPrefs metodo recupera il set corrente di preferenze di rendering usate dalla macchina virtuale.

Sintassi

HRESULT GetRenderingPrefs(
  [out] DWORD *pdwRenderFlags
);

Parametri

[out] pdwRenderFlags

Riceve un membro dell'enumerazione VMRRenderPrefs , che indica le preferenze di rendering correnti.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Codice restituito Descrizione
E_POINTER
 pdwRenderingPrefs non valido
VFW_E_WRONG_STATE
 Nessun oggetto allocatore-relatore è attualmente caricato.

Commenti

Questo metodo chiama tramite il metodo IVMRImagePresenterConfig::GetRenderingPrefs dell'allocatore-relatore. Il relatore allocatore predefinito espone IVMRImagePresenterConfig. I relatori allocatori personalizzati possono anche esporre questa interfaccia, se necessario. Se VMR-7 non ha ancora creato l'allocatore predefinito o se l'applicazione ha fornito un allocatore personalizzato che non supporta IVMRImagePresenterConfig, questo metodo restituisce VFW_E_WRONG_STATE. Per creare l'allocatore-relatore predefinito, chiamare IVMRFilterConfig::SetRenderingMode con il valore VMRMode_Windowed o VMRMode_Windowed.

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 IVMRFilterConfig

IVMRFilterConfig::SetRenderingPrefs

Uso del renderer di missaggio video