ID3D11VideoContext::VideoProcessorSetStreamPalette method

Sets the color-palette entries for an input stream on the video processor.


void VideoProcessorSetStreamPalette(
  [in]       ID3D11VideoProcessor *pVideoProcessor,
  [in]       UINT                 StreamIndex,
  [in]       UINT                 Count,
  [inconst UINT                 *pEntries


pVideoProcessor [in]

A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor.

StreamIndex [in]

The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member.

Count [in]

The number of elements in the pEntries array.

pEntries [in]

A pointer to an array of palette entries. For RGB streams, the palette entries use the DXGI_FORMAT_B8G8R8A8 representation. For YCbCr streams, the palette entries use the DXGI_FORMAT_AYUV representation. The caller allocates the array.

Return value

This method does not return a value.


This method applies only to input streams that have a palettized color format. Palettized formats with 4 bits per pixel (bpp) use the first 16 entries in the list. Formats with 8 bpp use the first 256 entries.

If a pixel has a palette index greater than the number of entries, the device treats the pixel as white with opaque alpha. For full-range RGB, this value is (255, 255, 255, 255); for YCbCr the value is (255, 235, 128, 128).

If the driver does not report the D3D11_VIDEO_PROCESSOR_FEATURE_CAPS_ALPHA_PALETTE capability flag, every palette entry must have an alpha value of 0xFF (opaque). To query for this capability, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps.


Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8



See also