ID3D12VideoDevice2::ExecuteExtensionCommand-Methode (d3d12video.h)

  • Artikel

Führt einen Videoerweiterungsbefehl aus.

Syntax

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

Parameter

pExtensionCommand

Zeiger auf einen ID3D12VideoExtensionCommand, der den auszuführenden Videoerweiterungsbefehl darstellt. Der Aufrufer ist für die Beibehaltung der Objektlebensdauer verantwortlich, bis die Befehlsausführung abgeschlossen ist.

pExecutionParameters

Ein Zeiger auf die Struktur der Ausführungseingabeparameter, die durch den Befehl definiert wird. Die Parameterstruktur muss den Parametern entsprechen, die durch einen Aufruf von ID3D12VideoDevice::CheckFeatureSupport mit dem Featurewert von D3D12_FEATURE_VIDEO_EXTENSION_COMMAND_PARAMETERS und einem Parameterstufenwert von D3D12_VIDEO_EXTENSION_COMMAND_PARAMETER_STAGE_EXECUTION aufgelistet werden.

ExecutionParametersSizeInBytes

Die Größe der pExecutionParameters-Parameterstruktur in Bytes.

pOutputData

Ein Zeiger auf die Struktur der Ausführungsausgabeparameter, die durch den Befehl definiert wird.

OutputDataSizeInBytes

Empfängt die Größe der pExecutionParameters-Parameterstruktur in Bytes.

Rückgabewert

Diese Methode gibt HRESULT zurück.

Hinweise

Videoerweiterungsbefehle, die über diese Methode ausgeführt werden, müssen abgeschlossen werden, bevor diese Methode zurückgegeben wird. Aus Gründen der Effizienz sollten Erweiterungsimplementierungen die Arbeit in Befehlslisten planen, anstatt diese Methode nach Möglichkeit zu verwenden. Jeder Videobefehlslistentyp bietet einen ExecuteExtensionCommand für geplante Arbeiten. Dazu gehören:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile d3d12video.h

Weitere Informationen