ID3D11VideoContext::VideoProcessorBlt method (d3d11.h)

Performs a video processing operation on one or more input samples, and writes the result to a Direct3D surface.

Syntax

HRESULT VideoProcessorBlt(
  [in] ID3D11VideoProcessor               *pVideoProcessor,
  [in] ID3D11VideoProcessorOutputView     *pView,
  [in] UINT                               OutputFrame,
  [in] UINT                               StreamCount,
  [in] const D3D11_VIDEO_PROCESSOR_STREAM *pStreams
);

Parameters

[in] pVideoProcessor

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

[in] pView

A pointer to the ID3D11VideoProcessorOutputView interface for the output surface. The output of the video processing operation will be written to this surface.

[in] OutputFrame

The frame number of the output video frame, indexed from zero.

[in] StreamCount

The number of input streams to process.

[in] pStreams

A pointer to an array of D3D11_VIDEO_PROCESSOR_STREAM structures that contain information about the input streams. The caller allocates the array and fills in each structure. The number of elements in the array is given in the StreamCount parameter.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The maximum value of StreamCount is given in the MaxStreamStates member of the D3D11_VIDEO_PROCESSOR_CAPS structure. The maximum number of streams that can be enabled at one time is given in the MaxInputStreams member of that structure.

If the output stereo mode is TRUE:

  • The output view must contain a texture array of two elements.
  • At least one stereo stream must be specified.
  • If multiple input streams are enabled, it is possible that one or more of the input streams may contain mono data.
Otherwise: This function does not honor a D3D11 predicate that may have been set.

If the application uses D3D11 queries, this function may not be accounted for with D3D11_QUERY_EVENT and D3D11_QUERY_TIMESTAMP when using feature levels lower than 11. D3D11_QUERY_PIPELINE_STATISTICS will not include this function for any feature level.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header d3d11.h

See also

ID3D11VideoContext interface