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 descodificador de microsoft DirectX Video Accelerator (VA) no estándar.
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 de DirectX VA 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. |
Comentarios
Un controlador de pantalla en modo de usuario puede implementar la función DecodeExtensionExecute para admitir extensiones a los tipos de descodificación estándar (es decir, GUID de descodificados no estándar). Estos tipos de descodificación no estándar son útiles para configurar el cifrado y otras mejoras diversas.
Se llama a DecodeExtensionExecute 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 pueden 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 de bDXVA_Func mayor que 4 se establece en los 8 bits más significativos del miembro Function de la estructura D3DDDIARG_DECODEEXTENSIONEXECUTE . También se llama a DecodeExtensionExecute 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, consulte los temas variables de DXVA_ConfigQueryOrReplyFlag y DXVA_ConfigQueryorReplyFunc y variables bDXVA_Func .
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 esta llamada de configuración antes de crear un dispositivo de descodificación, el miembro hDecode de la estructura D3DDDIARG_DECODEEXTENSIONEXECUTE a la que apunta el parámetro pData se establece 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 | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |