|Microsoft DirectShow 9.0|
The SetBorderColor method sets the border color to be used by the VMR.
HRESULT SetBorderColor( COLORREF Clr );
[in] Specifies the color as a COLORREF value.
The method returns an HRESULT. Possible values include those in the following table.
|S_OK||The method succeeded.|
The border color is used to fill any area of the destination rectangle that does not contain video. It is typically used in two situations:
- When the video straddles two monitors
- When the VMR is trying to maintain the aspect ratio of the movies by letter-boxing the video to fit within the specified destination rectangle. See SetAspectRatioMode.
Header: Include D3d9.h, Vmr9.h.
Library: Use Strmiids.lib.