PFND3D11_1DDI_VIDEOPROCESSORBLT callback function

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

Syntax

PFND3D11_1DDI_VIDEOPROCESSORBLT Pfnd3d111DdiVideoprocessorblt;

HRESULT Pfnd3d111DdiVideoprocessorblt(
   D3D10DDI_HDEVICE,
   D3D11_1DDI_HVIDEOPROCESSOR,
   D3D11_1DDI_HVIDEOPROCESSOROUTPUTVIEW,
   UINT,
   UINT,
  CONST D3D11_1DDI_VIDEO_PROCESSOR_STREAM *
)
{...}

Parameters

D3D10DDI_HDEVICE

D3D11_1DDI_HVIDEOPROCESSOR

D3D11_1DDI_HVIDEOPROCESSOROUTPUTVIEW

UINT

UINT

*

Return Value

VideoProcessorBlt returns one of the following values:

Return code Description
S_OK
The video processing operation completed successfully.
E_OUTOFMEMORY
Memory was not available to complete the operation.

Remarks

The VideoProcessorBlt performs all of the video processing based on the stream states and bit-block transfer (bitblt) states that have been previously set.

The Microsoft Direct3D runtime performs the following data validation before it calls the driver's VideoProcessorBlt function:

  • The input and output RECT structures may be adjusted if the rectangles are not aligned properly according to the requirements of the format.

  • If the video processor has been enabled to produce stereo samples, the output view must contain a texture array of two elements. Also, at least one stereo stream must be specified.

    If the video processor has been disabled from producing stereo samples, the output view must contain a single element. Also, the stereo format cannot be configured as D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO.

    Note A video processor is enabled or disabled for the production of stereo samples through a call to VideoProcessorSetOutputStereoMode.
  • Each input stream is specified through a D3D11_1DDI_VIDEO_PROCESSOR_STREAM structure. If the stereo format of the input stream is configured to be D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, the pInputSurfaceRight member must not be set to NULL. Otherwise, the pInputSurfaceRight must be set to NULL.
    Note The stereo format for an input stream is configured through a call to VideoProcessorSetStreamStereoFormat.
If multiple input streams are enabled and the video processor is enabled to produce stereo output, it is possible that one of the input streams may be a mono sample.
Note This function does not honor a D3D11 predicate that may have been set.

Requirements

   
Windows version Windows 8 Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See Also

D3D11_1DDI_VIDEO_PROCESSOR_STREAM

VideoProcessorSetOutputStereoMode

D3D11_1DDI_VIDEO_PROCESSOR_CAPS

CreateVideoProcessorOutputView

RECT

CreateVideoProcessor

VideoProcessorSetStreamStereoFormat

Send comments about this topic to Microsoft