PFND3D11_1DDI_VIDEODECODERBEGINFRAME fonction de rappel (d3d10umddi.h)

Article
02/26/2024

Démarre une opération de décodage DXVA (DirectX Video Acceleration) pour décoder une image vidéo.

Syntaxe

PFND3D11_1DDI_VIDEODECODERBEGINFRAME Pfnd3d111DdiVideodecoderbeginframe;

HRESULT Pfnd3d111DdiVideodecoderbeginframe(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11_1DDI_HDECODE unnamedParam2,
  const D3D11_1DDIARG_VIDEODECODERBEGINFRAME *unnamedParam3
)
{...}

Paramètres

unnamedParam1

hDevice [in]

Handle de l’appareil d’affichage (contexte graphique).

unnamedParam2

hDecoder [in]

Handle de l’objet de décodeur vidéo qui a été créé via un appel à la fonction CreateVideoDecoder .

unnamedParam3

pBeginFrame [in]

Pointeur vers une structure D3D11_1DDIARG_VIDEODECODERBEGINFRAME . Pour plus d'informations, consultez la section Notes.

Valeur retournée

VideoDecoderBeginFrame retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	L’opération de décodage a été démarrée avec succès.
E_OUTOFMEMORY	La mémoire n’était pas disponible pour terminer l’opération.

Remarques

Si le VideoDecoderBeginFrame retourne S_OK, le runtime Microsoft Direct3D appelle la fonction VideoDecoderSubmitBuffers pour effectuer les opérations de décodage. Une fois toutes les opérations de décodage exécutées, le runtime appelle la fonction VideoDecoderEndFrame pour arrêter l’opération de décodage sur une image vidéo.

Note Chaque appel à VideoDecoderBeginFrame doit avoir un appel correspondant à VideoDecoderEndFrame, et les appels VideoDecoderBeginFrame ne peuvent pas être imbriqués.

La structure D3D11_1DDIARG_VIDEODECODERBEGINFRAME contient les données suivantes :

Ressource qui recevra les données déchiffrées et décodées.
Clé de contenu utilisée pour chiffrer les données de trame vidéo.
Si le membre pContentKey de cette structure n’est pas défini sur NULL, la mémoire tampon référencée par ce membre contient une clé de contenu par image. Cette clé doit être utilisée pour déchiffrer les données au lieu d’utiliser la clé de session.

Note Si le membre pContentKey n’est pas défini sur NULL, la mémoire tampon référencée par ce membre est chiffrée à l’aide de la clé de session avec l’algorithme AES-ECB.

Si le membre pContentKey a la valeur NULL, les données de trame vidéo doivent être déchiffrées à l’aide de la clé de session.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

CreateVideoDecoder

VideoDecoderEndFrame

VideoDecoderSubmitBuffers

Partager via