IDirectXVideoDecoder ::GetCreationParameters, méthode (dxva2api.h)

Article
02/01/2024

Récupère les paramètres utilisés pour créer cet appareil.

Syntaxe

HRESULT GetCreationParameters(
  [out] GUID                      *pDeviceGuid,
  [out] DXVA2_VideoDesc           *pVideoDesc,
  [out] DXVA2_ConfigPictureDecode *pConfig,
  [out] IDirect3DSurface9         ***pDecoderRenderTargets,
  [out] UINT                      *pNumSurfaces
);

Paramètres

[out] pDeviceGuid

Reçoit le GUID de l’appareil. Ce paramètre peut être NULL.

[out] pVideoDesc

Pointeur vers une structure DXVA2_VideoDesc qui reçoit une description du format vidéo. Ce paramètre peut être NULL.

[out] pConfig

Pointeur vers une structure DXVA2_ConfigPictureDecode qui reçoit la configuration du décodeur. Ce paramètre peut être NULL.

[out] pDecoderRenderTargets

Reçoit un tableau de pointeurs d’interface IDirect3DSurface9 . Ces pointeurs représentent les cibles de rendu du décodeur. La méthode alloue la mémoire pour le tableau et appelle AddRef sur chacun des pointeurs. L’appelant doit libérer les pointeurs et appeler CoTaskMemFree pour libérer la mémoire du tableau. Ce paramètre peut être NULL.

[out] pNumSurfaces

Reçoit le nombre d’éléments dans le tableau pppDecoderRenderTargets . Ce paramètre peut être NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	Argument non valide. Au moins un paramètre doit être non NULL.

Remarques

Vous pouvez définir n’importe quel paramètre sur NULL si le résultat ne vous intéresse pas. Au moins un paramètre doit être non NULL.

Si vous spécifiez une valeur non NULL pour pppDecoderRenderTargets (pour recevoir les surfaces cibles de rendu), pNumSurfaces ne peut pas être NULL, car il reçoit la taille du tableau retournée dans pppDecoderenderTargets.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dxva2api.h

Voir aussi

Accélération vidéo DirectX 2.0

IDirectXVideoDecoder

Partager via