PFND3DDDI_DECODEEXTENSIONEXECUTE fonction de rappel (d3dumddi.h)
La fonction DecodeExtensionExecute effectue une opération de décodage à l’aide du périphérique de décodage non standard Microsoft DirectX Video Accelerator (VA) donné.
Syntaxe
PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;
HRESULT Pfnd3dddiDecodeextensionexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_DECODEEXTENSIONEXECUTE qui décrit l’opération de décodage VA DirectX à effectuer.
Valeur retournée
DecodeExtensionExecute retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| S_OK | L’opération de décodage va DirectX est effectuée avec succès. |
| E_OUTOFMEMORY | DecodeExtensionExecute n’a pas pu allouer la mémoire nécessaire à son exécution. |
Remarques
Un pilote d’affichage en mode utilisateur peut implémenter la fonction DecodeExtensionExecute pour prendre en charge les extensions des types de décodage standard (autrement dit, les GUID de décodage non standard). Ces types de décodage non standard sont utiles pour configurer le chiffrement et d’autres améliorations diverses.
DecodeExtensionExecute est appelé lorsque les décodeurs DirectX VA 2.0 nécessitent les extensions non standard.
Pour la compatibilité avec les décodeurs DirectX VA 1.0 qui peuvent nécessiter ces extensions non standard, DecodeExtensionExecute est appelé chaque fois qu’un décodeur DirectX VA 1.0 effectue un appel d’exécution dans lequel toute valeur de bDXVA_Func supérieure à 4 est définie dans les 8 bits les plus significatifs du membre Function de la structure D3DDDIARG_DECODEEXTENSIONEXECUTE . DecodeExtensionExecute est également appelé chaque fois que le décodeur DirectX VA 1.0 effectue un appel de configuration dans lequel tout indicateur de DXVA_ConfigQueryOrReplyFunc autre que l’indicateur DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) ou DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) est défini dans les 24 bits les plus significatifs de Function. Pour plus d’informations sur les significations des paramètres de bits de Function, consultez les rubriques variables DXVA_ConfigQueryOrReplyFlag et DXVA_ConfigQueryorReplyFunc et variables bDXVA_Func .
En raison de problèmes de compatibilité avec les décodeurs DirectX VA 1.0 qui peuvent effectuer un tel appel de configuration avant DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY, ces décodeurs peuvent effectuer un tel appel de configuration également avant la création d’un appareil de décodage. Si un tel appel de configuration est effectué avant la création d’un appareil de décodage, le membre hDecode de la structure D3DDDIARG_DECODEEXTENSIONEXECUTE vers laquelle pointe le paramètre pData a la valeur NULL. Dans ce cas, le pilote peut être amené à retourner une erreur (par exemple, E_FAIL) si le pilote ne peut pas prendre en charge la situation indépendamment d’un périphérique de décodage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |