функция обратного вызова PFND3DDDI_DECODEEXTENSIONEXECUTE (d3dumddi.h)
Функция DecodeExtensionExecute выполняет операцию декодирования с помощью заданного нестандартного устройства расширения DirectX Video Accelerator (DXVA).
Синтаксис
PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;
HRESULT Pfnd3dddiDecodeextensionexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}
Параметры
hDevice
Дескриптор устройства отображения (графический контекст).
unnamedParam2
pData [in, out]
Указатель на структуру D3DDDIARG_DECODEEXTENSIONEXECUTE, описывающую операцию декодации DXVA для выполнения.
Возвращаемое значение
DecodeExtensionExecute возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| S_OK | Операция декодирования DirectX VA успешно выполнена. |
| E_OUTOFMEMORY | DecodeExtensionExecute не удалось выделить необходимую память для завершения. |
Замечания
Драйвер отображения в пользовательском режиме (UMD) может реализовать функцию DecodeExtensionExecute для поддержки расширений стандартных типов декодирования (то есть нестандартного декодирования GUID). Эти нестандартные типы декодирования полезны для настройки шифрования и других других улучшений.
ДекодированияExtensionExecute вызывается, когда декодеры DirectX VA 2.0 требуют нестандартных расширений.
Для совместимости с декодировщиками DirectX VA 1.0, которые могут потребовать этих нестандартных расширений, DecodeExtensionExecute вызывается всякий раз, когда декодирования DirectX VA 1.0 выполняет вызов выполнения, в котором любое bDXVA_Func значение, превышающее 4, устанавливается в наиболее значимых 8 битах функции член структуры D3DDDIARG_DECODEEXTENSIONEXECUTE. ДекодированияExtensionExecute также вызывается всякий раз, когда декодатор 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, эти декодеры могут вызвать такой вызов конфигурации также перед созданием устройства декодирования. Если перед созданием декодирования устройства создается такой вызов конфигурации, то элемент hDecode член структуры D3DDDIARG_DECODEEXTENSIONEXECUTE, на который указывает параметр pData, имеет значение NULL. В этой ситуации драйвер может потребоваться вернуть ошибку (например, E_FAIL), если драйвер не может поддерживать ситуацию независимо от декодера.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dumddi.h (include D3dumddi.h) |