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

Функция 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 возвращает одно из следующих значений:

Комментарии

Драйвер отображения пользовательского режима может реализовать функцию 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), если драйвер не может поддерживать ситуацию независимо от устройства декодирования.

Требования

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

D3DDDIARG_DECODEEXTENSIONEXECUTE

D3DDDI_DEVICEFUNCS