PFND3DWDDM2_0DDI_VIDEOPROCESSORGETBEHAVIORHINTS callback function (d3d10umddi.h)

Article
02/22/2024

Returns driver hints as to which video processor operations are best performed using multi-plane overlay hardware rather than VideoProcessorBlt. Optional for Windows Display Driver Model (WDDM) 2.0, or later, drivers.

Syntax

PFND3DWDDM2_0DDI_VIDEOPROCESSORGETBEHAVIORHINTS Pfnd3dwddm20DdiVideoprocessorgetbehaviorhints;

HRESULT Pfnd3dwddm20DdiVideoprocessorgetbehaviorhints(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HVIDEOPROCESSOR hVideoProcessor,
  UINT OutputWidth,
  UINT OutputHeight,
  DXGI_FORMAT OutputFormat,
  UINT StreamCount,
  const D3DWDDM2_0DDI_VIDEO_PROCESSOR_STREAM_BEHAVIOR_HINT *pStreams,
  UINT *pBehaviorHints
)
{...}

Parameters

hDevice

A handle to the display device (graphics context). The Direct3D runtime passed the user-mode driver this handle as the hDevice member of the D3DDDIARG_CREATEDEVICE structure at device creation.

hVideoProcessor

Handle to the video processor object.

OutputWidth

Indicates the width of the output surface.

OutputHeight

Indicates the height of the output surface.

OutputFormat

Indicates the output format of the video processor.

StreamCount

The number of input streams to process.

pStreams

An array of structures indicating the format and status of each stream.

pBehaviorHints

Receives a combination of D3DWDDM2_0DDI_VIDEO_PROCESSOR_MULTIPLANE_BEHAVIOR_HINTS values indicting which of the operations would best be performed using multi-plane overlay hardware rather than with VideoProcessorBlt.

Return value

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

Remarks

This function uses the current state, set via the VideoProcessorSetOutput and VideoProcessorSetStream set of device driver interfaces (DDIs), and returns which operations could be performed more efficiently using multiple overlay hardware.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Desktop
Header	d3d10umddi.h (include D3d10umddi.h)