ID3D11VideoContext::VideoProcessorBlt Method

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

Syntax

public:
HRESULT VideoProcessorBlt(
         ID3D11VideoProcessor *pVideoProcessor,
         ID3D11VideoProcessorOutputView *pView,
         UINT OutputFrame,
         UINT StreamCount,
         const D3D11_VIDEO_PROCESSOR_STREAM *pStreams
)  

Parameters

pVideoProcessor
Type: ID3D11VideoProcessor *

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

pView
Type: ID3D11VideoProcessorOutputView *

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

OutputFrame
Type: UINT 

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

StreamCount
Type: UINT 

[in] The number of input streams to process.

pStreams
Type: D3D11_VIDEO_PROCESSOR_STREAM *

[in] 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

Type: HRESULT 

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

See Direct3D 11 return codes for possible return values.

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:

• The output view must contain a single element.
• The stereo format cannot be D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO .

This function does not honor a D3D11 predicate that may have been set.

If the application uses D3D11 quries, 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

Header: Declared in d3d11_x.h (d3d11.h on other Windows platforms).