PFND3DDDI_DECODEEXTENSIONEXECUTE función de devolución de llamada (d3dumddi.h)
La función DecodeExtensionExecute realiza una operación de descodificación mediante el dispositivo de extensión directX Video Accelerator (DXVA) no estándar especificado.
Sintaxis
PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;
HRESULT Pfnd3dddiDecodeextensionexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}
Parámetros
hDevice
Identificador del dispositivo de visualización (contexto de gráficos).
unnamedParam2
pData [in, out]
Puntero a una estructura de D3DDDIARG_DECODEEXTENSIONEXECUTE que describe la operación de descodificación DXVA que se va a realizar.
Valor devuelto
DecodeExtensionExecute devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | La operación de descodificación de DirectX VA se realiza correctamente. |
| E_OUTOFMEMORY | DecodeExtensionExecute no pudo asignar la memoria necesaria para que se complete. |
Observaciones
Un controlador de visualización en modo de usuario (UMD) puede implementar la función de DecodeExtensionExecuteExecute para admitir extensiones a los tipos de descodificación estándar (es decir, GUID de descodificación no estándar). Estos tipos de descodificación no estándar son útiles para configurar el cifrado y otras mejoras diversas.
descodificadorExtensionExecute se llama cuando los descodificadores de DirectX VA 2.0 requieren las extensiones no estándar.
Para la compatibilidad con los descodificadores de DirectX VA 1.0 que podrían requerir estas extensiones no estándar, se llama a DecodeExtensionExecute cada vez que un descodificador DirectX VA 1.0 realiza una llamada de ejecución en la que cualquier valor bDXVA_Func mayor que 4 se establece en los 8 bits más significativos de la función miembro de la estructura D3DDDIARG_DECODEEXTENSIONEXECUTE. descodificadorExtensionExecute también se llama cada vez que el descodificador DirectX VA 1.0 realiza una llamada de configuración en la que cualquier marca de DXVA_ConfigQueryOrReplyFunc distinta de DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) o DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) se establece en los 24 bits más significativos de Function. Para obtener más información sobre los significados de la configuración de bits de Function, vea los temas DXVA_ConfigQueryOrReplyFlag y variables de DXVA_ConfigQueryorReplyFunc y bDXVA_Func variable.
Debido a problemas de compatibilidad con los descodificadores de DirectX VA 1.0 que podrían realizar dicha llamada de configuración antes de DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY, esos descodificadores también pueden realizar dicha llamada de configuración antes de crear un dispositivo de descodificación. Si se realiza dicha llamada de configuración antes de crear un dispositivo de descodificación, el hDecode miembro de la estructura de D3DDDIARG_DECODEEXTENSIONEXECUTE que el parámetro pData apunta a está establecido en NULL. En esta situación, es posible que sea necesario que el controlador devuelva un error (por ejemplo, E_FAIL) si el controlador no puede admitir la situación independientemente de un dispositivo de descodificación.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |