structure D3DDDIARG_VIDEOPROCESSBLT (d3dumddi.h)

Article
08/07/2023

La structure D3DDDIARG_VIDEOPROCESSBLT décrit une opération de traitement vidéo Microsoft DirectX Video Acceleration (VA) à effectuer.

Syntaxe

typedef struct _D3DDDIARG_VIDEOPROCESSBLT {
  [in] REFERENCE_TIME               TargetFrame;
  [in] HANDLE                       hVideoProcess;
  [in] RECT                         TargetRect;
  [in] SIZE                         ConstrictionSize;
  [in] UINT                         StreamingFlags;
  [in] DXVADDI_AYUVSAMPLE16         BackgroundColor;
  [in] DXVADDI_EXTENDEDFORMAT       DestFormat;
  [in] DXVADDI_VIDEOPROCESSBLTFLAGS DestFlags;
  [in] DXVADDI_PROCAMPVALUES        ProcAmpValues;
  [in] DXVADDI_FIXED32              Alpha;
  [in] DXVADDI_FILTERVALUES         NoiseFilterLuma;
  [in] DXVADDI_FILTERVALUES         NoiseFilterChroma;
  [in] DXVADDI_FILTERVALUES         DetailFilterLuma;
  [in] DXVADDI_FILTERVALUES         DetailFilterChroma;
  [in] DXVADDI_VIDEOSAMPLE          *pSrcSurfaces;
  [in] UINT                         NumSrcSurfaces;
} D3DDDIARG_VIDEOPROCESSBLT;

Membres

[in] TargetFrame

Valeur REFERENCE_TIME qui identifie l’emplacement de l’image de sortie dans la séquence d’images d’entrée. Si seul le désentlacement est effectué, l’heure cible doit coïncider avec l’heure d’affichage de début d’un exemple, telle que définie par le membre Start dans la structure DXVADDI_VIDEOSAMPLE , ou le point intermédiaire entre l’heure d’affichage de début et l’heure d’affichage de fin.

Si une conversion de fréquence d’images est demandée, l’heure dans TargetFrame peut être différente de n’importe quelle heure dans les membres Start des exemples.

[in] hVideoProcess

Handle du périphérique de traitement vidéo DirectX VA. Le pilote d’affichage en mode utilisateur retourne ce handle dans un appel à sa fonction CreateVideoProcessDevice .

[in] TargetRect

Pointeur vers une structure RECT qui décrit l’emplacement dans la surface de destination dans laquelle l’image de sortie est écrite. Notez que l’image de sortie est limitée aux pixels dans le rectangle pointé par TargetRect. Autrement dit, chaque pixel de ce rectangle doit être écrit dans ; les pixels situés à l’extérieur de ce rectangle ne doivent pas être modifiés.

[in] ConstrictionSize

Structure SIZE qui spécifie, pour le contenu protégé, la taille à laquelle réduire l’image de sortie. ConstrictionSize doit être comprise entre (1, 1) et (largeur, hauteur) du rectangle cible spécifié dans le membre TargetRect . ConstrictionSize doit être (0, 0) pour ne représenter aucune constriction.

Par exemple, considérez une vidéo qui a 1920 x 1080 pixels en mode natif et qui s’affiche en plein écran sur un moniteur de résolution 1920 x 1080 pour lequel la protection de sortie n’est pas prise en charge. Si le contenu vidéo spécifie une règle selon laquelle seulement 854 x 480 pixels d’informations d’origine peuvent être affichés, le pilote doit réduire l’image d’origine de 1920 x 1080 à 854 x 480, puis étendre à nouveau l’image à 1920 x 1080. Dans cet exemple, la structure SIZE du membre ConstrictionSize spécifie une taille de 854 x 480 pixels.

[in] StreamingFlags

Valeur UINT qui identifie les indicateurs de diffusion en continu. Actuellement, aucun indicateur de diffusion en continu n’est défini.

[in] BackgroundColor

Structure DXVADDI_AYUVSAMPLE16 qui identifie la couleur d’arrière-plan.

[in] DestFormat

Une structure DXVADDI_EXTENDEDFORMAT qui identifie les informations de format étendu pour la surface de destination.

[in] DestFlags

Une structure DXVADDI_VIDEOPROCESSBLTFLAGS qui identifie les modifications apportées à l’aire de destination actuelle par rapport à l’aire de destination précédente.

[in] ProcAmpValues

Une structure DXVADDI_PROCAMPVALUES qui spécifie les données d’ajustement ProcAmp qui sont sorties sur la surface de destination.

[in] Alpha

Une structure DXVADDI_FIXED32 qui spécifie la valeur de transparence planaire de l’image de sortie telle qu’elle est écrite sur l’aire de destination. Lorsque la valeur alpha est 1.0, la couleur d’arrière-plan est dessinée opaque (sans transparence et mélange alpha). Lorsque la valeur alpha est 0,0, l’arrière-plan ne doit pas être dessiné (transparent).

[in] NoiseFilterLuma

Structure DXVADDI_FILTERVALUES qui spécifie le filtre de bruit luma.

[in] NoiseFilterChroma

Structure DXVADDI_FILTERVALUES qui spécifie le filtre de bruit chromatique.

[in] DetailFilterLuma

Structure DXVADDI_FILTERVALUES qui spécifie le filtre de détail luma.

[in] DetailFilterChroma

Structure DXVADDI_FILTERVALUES qui spécifie le filtre de détails de la chroma.

[in] pSrcSurfaces

Tableau de structures DXVADDI_VIDEOSAMPLE qui décrivent les exemples d’entrée requis pour les opérations de désentlacation, de conversion de fréquence d’images et de composition de sous-flux. Pour plus d’informations sur la façon dont les exemples d’entrée sont organisés dans ce tableau, consultez Ordre de mémoire tampon d’entrée.

[in] NumSrcSurfaces

Nombre d’exemples d’entrée dans le tableau à pSrcSurfaces.

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.
En-tête	d3dumddi.h (inclure D3dumddi.h)