DXVAHD_BLT_STATE_BACKGROUND_COLOR_DATA structure (dxvahd.h)

Specifies the background color for blit operations, when using Microsoft DirectX Video Acceleration High Definition (DXVA-HD).

Syntax

typedef struct _DXVAHD_BLT_STATE_BACKGROUND_COLOR_DATA {
  BOOL         YCbCr;
  DXVAHD_COLOR BackgroundColor;
} DXVAHD_BLT_STATE_BACKGROUND_COLOR_DATA;

Members

YCbCr

If TRUE, the BackgroundColor member specifies a YCbCr color. Otherwise, it specifies an RGB color. The default device state is FALSE (RGB color).

BackgroundColor

A DXVAHD_COLOR union that specifies the background color. The default state value is (0.0, 0.0, 0.0, 1.0).

Remarks

The background color is used to fill the target rectangle wherever no video image appears. Areas outside the target rectangle are not affected. See DXVAHD_BLT_STATE_TARGET_RECT_DATA.

The color space of the background color is determined by the color space of the output. See DXVAHD_BLT_STATE_OUTPUT_COLOR_SPACE_DATA.

The alpha value of the background color is used only when the alpha fill mode is DXVAHD_ALPHA_FILL_MODE_BACKGROUND. Otherwise, the alpha value is ignored. See DXVAHD_BLT_STATE_ALPHA_FILL_DATA.

The default background color is full-range RGB black, with opaque alpha.

Examples

HRESULT DXVAHD_SetBackgroundColor(
    IDXVAHD_VideoProcessor *pVP,
    BOOL bYCbCr,
    const DXVAHD_COLOR& color
    )
{
    DXVAHD_BLT_STATE_BACKGROUND_COLOR_DATA data = { bYCbCr, color };

    HRESULT hr = pVP->SetVideoProcessBltState(
        DXVAHD_BLT_STATE_BACKGROUND_COLOR,
        sizeof (data),
        &data
        );

    return hr;
}

Requirements

See also

DXVA-HD

DXVAHD_BLT_STATE

Direct3D Video Structures

IDXVAHD_VideoProcessor::SetVideoProcessBltState

Media Foundation Structures