VideoProcessorSetStreamSourceRect function

Sets the source rectangle for an input stream on the video processor.


VOID APIENTRY* VideoProcessorSetStreamSourceRect(
  _In_       D3D10DDI_HDEVICE           hDevice,
  _In_       D3D11_1DDI_HVIDEOPROCESSOR hVideoProcessor,
  _In_       UINT                       StreamIndex,
  _In_       BOOL                       Enable,
  _In_ const RECT                       *pSourceRect


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.

StreamIndex [in]

The zero-based index of the input stream.

Enable [in]

If TRUE, the specified source rectangle must be applied to the input stream.

If FALSE, no source rectangle is applied to the input stream.

pSourceRect [in]

A pointer to a RECT structure that specifies the source rectangle.

Note  If the Enable parameter is FALSE, this parameter is ignored.

Return value

This function does not return a value.


The source rectangle is the portion of the input surface from which the video processor performs a bit-block transfer (bitblt) to the destination surface. The source rectangle is given in pixel coordinates, relative to the input surface.

If the VideoProcessorSetStreamSourceRect function is never called, or if the Enable parameter is FALSE, the video processor reads from the entire input surface.


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Target platform



D3d10umddi.h (include D3d10umddi.h)

See also




Send comments about this topic to Microsoft