Expand Minimize

VideoProcessorSetOutputColorSpace function

Sets the output color space for the video processor.

Syntax


VOID APIENTRY* VideoProcessorSetOutputColorSpace(
  _In_  D3D10DDI_HDEVICE hDevice,
  _In_  D3D11_1DDI_HVIDEOPROCESSOR hVideoProcessor,
  _In_  const D3D11_1DDI_VIDEO_PROCESSOR_COLOR_SPACE *pColorspace
);

Parameters

hDevice [in]

A handle to the display device (graphics context).

hVideoProcessor [in]

A handle to the video processor object that was created through a call to the CreateVideoProcessor function.

pColorspace [in]

A pointer to a D3D11_1DDI_VIDEO_PROCESSOR_COLOR_SPACE structure that specifies the color space.

Return value

This function does not return a value.

Remarks

The D3D11_1DDI_VIDEO_PROCESSOR_COLOR_SPACE structure includes the following members:

  • The Usage member specifies whether the output is intended for playback or video processing, such as editing or authoring. The driver can optimize the video processing based on the specified usage.

  • The RGB_Range member specifies the RGB color range. If this member is set to zero, the transfer matrix is based on the . If this member is set to one, the RGB range is limited to index values from 16 to 235.

  • The YCbCr_Matrix member specifies the YCbCr transfer matrix. If this member is set to zero, the transfer matrix is based on the BT.601 format. If this member is set to one, the transfer matrix is based on the BT.709 format.

    Note  Both of these transfer matrixes define the black point as index 16 and the white point as index 235.

  • The YCbCr_xvYCC member specifies whether the output uses the conventional YCbCr format or the extended YCbCr (xvYCC) format.

    If this member is set to zero, the format that is used is the conventional YCbCr format.

    If this member is set to one, the format that is used is the extended xvYCC format.

    Note  The xvYCC format can be used with either YCbCr transfer matrix and also defines the black point as index 16 and the white point as index 235. However, the xvYCC format supports blacker luminance values in the range from 1 to 15. The xvYCC format also supports whiter luminance values in the range from 236 to 254. Therefore, the graphics adapter must not adjust these luminance values to the standard 16 and 235 index values for the white and black point respectively.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CreateVideoProcessor
D3D11_1DDI_VIDEO_PROCESSOR_COLOR_SPACE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft