IVMRMixerControl9::SetMixingPrefs

 
Microsoft DirectShow 9.0

IVMRMixerControl9::SetMixingPrefs

The SetMixingPrefs method sets the mixing preferences for the stream.

Syntax

  HRESULT SetMixingPrefs(
  DWORD  dwMixerPrefs
);

Parameters

dwMixerPrefs

[in]   Bitwise OR combination of VMR9MixerPrefs flags.

Return Values

The method returns an HRESULT. Possible values include those in the following table.

Value Description
S_OK The method succeeded.

Remarks

The flags for the mixing preferences are divided into three groups: decimation, filtering, and render target. The VMR9MixerPrefs enumeration defines bitmasks to isolate these flags:

  • MixerPref9_DecimateMask
  • MixerPref9_FilteringMask
  • MixerPref9_RenderTargetMask

You must specify a valid flag for each group. If you want to change a single flag, you can get the current preferences, remove the flag you don't want, and add the flag you want. For example:

// Get the current mixing preferences.
DWORD dwPrefs;
pMixControl->GetMixingPrefs(&dwPrefs);  

// Remove the current render target flag.
dwPrefs &= ~MixerPref_RenderTargetMask; 

// Add the render target flag that we want.
dwPrefs |= MixerPref_RenderTargetYUV;

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

If the VMR is in renderless mode, you must set the allocator-presenter before calling SetMixingPrefs. Otherwise, the VMR cannot determine the capabilities of the Direct3D device.

Requirements

Header: Include D3d9.h, Vmr9.h.

Library: Use Strmiids.lib.

See Also