PFND3DDDI_DECODEEXECUTE fonction de rappel (d3dumddi.h)
La fonction DecodeExecute effectue une opération de décodage à l’aide de l’appareil de décodage microsoft DirectX Video Accelerator (VA) donné.
Syntaxe
PFND3DDDI_DECODEEXECUTE Pfnd3dddiDecodeexecute;
HRESULT Pfnd3dddiDecodeexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXECUTE *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in]
Pointeur vers une structure D3DDDIARG_DECODEEXECUTE qui décrit l’opération de décodage DirectX VA à effectuer.
Valeur de retour
DecodeExecute retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| S_OK | L’opération de décodage DirectX VA est effectuée avec succès. |
| E_OUTOFMEMORY | DecodeExecute n’a pas pu allouer la mémoire requise pour qu’elle soit terminée. |
Remarques
Le runtime Microsoft Direct3D appelle la fonction DecodeExecute pour toutes les opérations de décodage DirectX VA standard. Lorsque DécodageExecute est d’abord appelé pour chaque image, la structure D3DDDIARG_DECODEEXECUTE spécifiée par pData doit contenir toutes les informations de mémoire tampon requises pour décoder le frame. DecodeExecute peut par la suite être appelée pour le même frame ; Toutefois, ces appels nécessitent uniquement des données incrémentielles. Si le GUID du type de décodage DirectX VA particulier n’utilise pas de mémoire tampon spécifiée dans D3DDDIARG_DECODEEXECUTE, le handle et la description de la mémoire tampon sont définis sur NULL. Par exemple, étant donné que le type de décodage MPEG2 nécessite des paramètres d’image, une mémoire tampon de macroblock et une mémoire tampon de différence résiduelle, tous ces éléments doivent être présents dans le premier appel pour chaque image. En fonction de la taille des données, toutefois, le runtime Direct3D peut appeler DecodeExecute de nouveau pour fournir uniquement des données résiduelles supplémentaires requises pour décoder l’intégralité de l’image.
DirectX VA 1.0 a pris en charge un mécanisme de synchronisation externe via un appel à la fonction DdMoCompQueryStatus. Dans DirectX VA 2.0, le pilote d’affichage en mode utilisateur doit effectuer sa propre synchronisation, similaire à la façon dont il synchronise le canal 3D. Pour plus d’informations sur cette synchronisation, consultez synchronisation des opérations de décodage vidéo.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |