Edit

Share via

ID3D12VideoDevice2::ExecuteExtensionCommand method (d3d12video.h)

  • Article

Executes a video extension command.

Syntax

HRESULT ExecuteExtensionCommand(
  ID3D12VideoExtensionCommand *pExtensionCommand,
  const void                  *pExecutionParameters,
  SIZE_T                      ExecutionParametersSizeInBytes,
  void                        *pOutputData,
  SIZE_T                      OutputDataSizeInBytes
);

Parameters

pExtensionCommand

Pointer to an ID3D12VideoExtensionCommand representing the video extension command to execute. The caller is responsible for maintaining object lifetime until command execution is complete.

pExecutionParameters

A pointer to the execution input parameters structure, which is defined by the command. The parameters structure must match the parameters enumerated by a call to ID3D12VideoDevice::CheckFeatureSupport with the feature value of D3D12_FEATURE_VIDEO_EXTENSION_COMMAND_PARAMETERS and a parameter stage value of D3D12_VIDEO_EXTENSION_COMMAND_PARAMETER_STAGE_EXECUTION.

ExecutionParametersSizeInBytes

The size of the pExecutionParameters parameter structure, in bytes.

pOutputData

A pointer to the execution output parameters structure, which is defined by the command.

OutputDataSizeInBytes

Receives the size of the pExecutionParameters parameter structure, in bytes.

Return value

This method returns HRESULT.

Remarks

Video extension commands executed through this method must complete before this method returns. For efficiency, extension implementations should schedule work in command lists instead of using this method, whenever possible. Each video command list type provides an ExecuteExtensionCommand for scheduled work. These include:

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Header d3d12video.h

See also