функция обратного вызова PFND3DDDI_DECODEEXTENSIONEXECUTE (d3dumddi.h)

Статья
03/08/2023

Функция DecodeExtensionExecute выполняет операцию декодирования с помощью заданного нестандартного устройства декодирования Microsoft DirectX Video Accelerator (VA).

Синтаксис

PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;

HRESULT Pfnd3dddiDecodeextensionexecute(
  HANDLE hDevice,
  const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pData [in, out]

Указатель на структуру D3DDDIARG_DECODEEXTENSIONEXECUTE , описывающую операцию декодирования DirectX VA.

Возвращаемое значение

DecodeExtensionExecute возвращает одно из следующих значений:

Код возврата	Описание
S_OK	Операция декодирования DirectX VA успешно выполнена.
E_OUTOFMEMORY	DecodeExtensionExecute не удалось выделить необходимую память для ее завершения.

Драйвер отображения пользовательского режима может реализовать функцию DecodeExtensionExecute для поддержки расширений стандартных типов декодирования (то есть нестандартных GUID декодирования). Эти нестандартные типы декодирования полезны для настройки шифрования и других улучшений.

DecodeExtensionExecute вызывается, когда декодеры DirectX VA 2.0 требуют нестандартных расширений.

Для совместимости с декодерами DirectX VA 1.0, которым могут потребоваться эти нестандартные расширения, DecodeExtensionExecute вызывается всякий раз, когда декодер DirectX VA 1.0 выполняет вызов выполнения, в котором любое значение bDXVA_Func, превышающее 4, задается в наиболее значимых 8 битах элемента Functionструктуры D3DDDIARG_DECODEEXTENSIONEXECUTE . DecodeExtensionExecute также вызывается всякий раз, когда декодер DirectX VA 1.0 выполняет вызов конфигурации, в котором любой флаг DXVA_ConfigQueryOrReplyFunc, отличный от флага DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) или DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5), устанавливается в наиболее значимых 24 битах функции. Дополнительные сведения о значениях битовых параметров функции см. в разделах DXVA_ConfigQueryOrReplyFlag и DXVA_ConfigQueryorReplyFunc Переменные и переменные bDXVA_Func .

Из-за проблем совместимости с декодерами DirectX VA 1.0, которые могут выполнять такой вызов конфигурации до DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY, эти декодеры могут выполнять такой вызов конфигурации также до создания устройства декодирования. Если такой вызов конфигурации выполняется перед созданием устройства декодирования, элемент hDecodeD3DDDIARG_DECODEEXTENSIONEXECUTE структуры, на которую указывает параметр pData , имеет значение NULL. В этом случае драйвер может потребоваться вернуть ошибку (например, E_FAIL), если драйвер не может поддерживать ситуацию независимо от устройства декодирования.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	d3dumddi.h (включая D3dumddi.h)

См. также раздел

D3DDDIARG_DECODEEXTENSIONEXECUTE

D3DDDI_DEVICEFUNCS