IDirectDrawVideo::SetSwitches method (amvideo.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The SetSwitches method sets the surface types that the renderer is allowed to use.
Syntax
HRESULT SetSwitches(
DWORD Switches
);
Parameters
Switches
Bit mask containing one or more of the following DirectShow DirectDraw Surface (AMDDS) surface types.
| Value | Description |
|---|---|
| AMDDS_NONE | No use for DCI/DirectDraw. |
| AMDDS_DCIPS | Use DCI primary surface. |
| AMDDS_PS | Use DirectDraw primary surface. |
| AMDDS_RGBOVR | RGB overlay surfaces. |
| AMDDS_YUVOVR | YUV overlay surfaces. |
| AMDDS_RGBOFF | RGB off-screen surfaces. |
| AMDDS_YUVOFF | YUV off-screen surfaces. |
| AMDDS_RGBFLP | RGB flipping surfaces. |
| AMDDS_YUVFLP | YUV flipping surfaces. |
| AMDDS_ALL | All the previous flags. |
| AMDDS_DEFAULT | Use all available surfaces. |
| AMDDS_YUV | (AMDDS_YUVOFF | AMDDS_YUVOVR | AMDDS_YUVFLP). |
| AMDDS_RGB | (AMDDS_RGBOFF | AMDDS_RGBOVR | AMDDS_RGBFLP). |
| AMDDS_PRIMARY | (AMDDS_DCIPS | AMDDS_PS). |
Return value
Returns an HRESULT value.
Remarks
This method must be called before the Video Renderer is connected.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | amvideo.h (include Dshow.h) |
| Library | Strmiids.lib |