PFND3DDDI_VIDEOPROCESSBEGINFRAME callback function (d3dumddi.h)

Article
02/22/2024

The VideoProcessBeginFrame function notifies the user-mode display driver that processing of a video frame can begin on the specified Microsoft DirectX Video Accelerator (VA) video processing device.

Syntax

PFND3DDDI_VIDEOPROCESSBEGINFRAME Pfnd3dddiVideoprocessbeginframe;

HRESULT Pfnd3dddiVideoprocessbeginframe(
       HANDLE hDevice,
  [in] HANDLE hVideoProcess
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

[in] hVideoProcess

The handle to the DirectX VA video processing device that should start processing the video frame. The CreateVideoProcessDevice function created this handle.

Return value

VideoProcessBeginFrame returns one of the following values:

Return code	Description
S_OK	Video frame processing successfully began.
E_OUTOFMEMORY	VideoProcessBeginFrame could not allocate the required memory for it to complete.

Remarks

The VideoProcessBeginFrame function notifies the user-mode display driver that its VideoProcessBlt function can be called on the specified video processing device.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	d3dumddi.h (include D3dumddi.h)