ID3D12VideoDevice2::ExecuteExtensionCommand-Methode (d3d12video.h)
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:
- ID3D12VideoDecodeComandlist2::ExecuteExtensionCommand
- ID3D12VideoEncodeComandlist1::ExecuteExtensionCommand
- ID3D12VideoProcessComandlist2::ExecuteExtensionCommand
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 Build 20348 |
| Unterstützte Mindestversion (Server) | Windows 10 Build 20348 |
| Kopfzeile | d3d12video.h |