IVMRMixerControl::SetMixingPrefs-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Legt die Mischeinstellungen für den Stream fest.

Syntax

HRESULT SetMixingPrefs(
  [in] DWORD dwMixerPrefs
);

Parameter

[in] dwMixerPrefs

Bitweise OR-Kombination von VMRMixerPrefs-Flags .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Die Flags für die Mischeinstellungen sind in drei Gruppen unterteilt: Dezimierung, Filterung und Renderziel. Die VMRMixerPrefs-Enumeration definiert Bitmasken, um diese Flags zu isolieren:

  • MixerPref_DecimateMask
  • MixerPref_FilteringMask
  • MixerPref_RenderTargetMask
Sie müssen für jede Gruppe ein gültiges Flag angeben. Wenn Sie ein einzelnes Flag ändern möchten, können Sie die aktuellen Einstellungen abrufen, das nicht gewünschte Flag entfernen und das gewünschte Flag hinzufügen. Beispiel:
C++
Rufen Sie die aktuellen Mischeinstellungen ab.
DWORD dwPrefs; pMixControl-GetMixingPrefs>(&dwPrefs);

Entfernen Sie das aktuelle Renderzielflag. dwPrefs &= ~MixerPref_RenderTargetMask;

Fügen Sie das gewünschte Renderzielflag hinzu. dwPrefs |= MixerPref_RenderTargetYUV;

// Set the new flags. pMixControl->SetMixingPrefs(dwPrefs);

Wenn sich die VMR im renderlosen Modus befindet, müssen Sie den Zuweisungs-Presenter festlegen, bevor Sie aufrufen SetMixingPrefs. Andernfalls kann die VMR die Funktionen des Direct3D-Geräts nicht ermitteln.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IVMRMixerControl-Schnittstelle

Verwenden des Videomischrenderers