structure DXVA_PictureParameters (dxva.h)

La structure DXVA_PictureParameters est envoyée par le décodeur hôte à l’accélérateur pour fournir les paramètres au niveau de l’image d’une image compressée pour le décodage sur l’accélérateur.

Syntaxe

typedef struct _DXVA_PictureParameters {
  WORD wDecodedPictureIndex;
  WORD wDeblockedPictureIndex;
  WORD wForwardRefPictureIndex;
  WORD wBackwardRefPictureIndex;
  WORD wPicWidthInMBminus1;
  WORD wPicHeightInMBminus1;
  BYTE bMacroblockWidthMinus1;
  BYTE bMacroblockHeightMinus1;
  BYTE bBlockWidthMinus1;
  BYTE bBlockHeightMinus1;
  BYTE bBPPminus1;
  BYTE bPicStructure;
  BYTE bSecondField;
  BYTE bPicIntra;
  BYTE bPicBackwardPrediction;
  BYTE bBidirectionalAveragingMode;
  BYTE bMVprecisionAndChromaRelation;
  BYTE bChromaFormat;
  BYTE bPicScanFixed;
  BYTE bPicScanMethod;
  BYTE bPicReadbackRequests;
  BYTE bRcontrol;
  BYTE bPicSpatialResid8;
  BYTE bPicOverflowBlocks;
  BYTE bPicExtrapolation;
  BYTE bPicDeblocked;
  BYTE bPicDeblockConfined;
  BYTE bPic4MVallowed;
  BYTE bPicOBMC;
  BYTE bPicBinPB;
  BYTE bMV_RPS;
  BYTE bReservedBits;
  WORD wBitstreamFcodes;
  WORD wBitstreamPCEelements;
  BYTE bBitstreamConcealmentNeed;
  BYTE bBitstreamConcealmentMethod;
} DXVA_PictureParameters, *LPDXVA_PictureParameters;

Membres

wDecodedPictureIndex

Spécifie la mémoire tampon de trame de destination pour les macroblocks décodés.

wDeblockedPictureIndex

Spécifie la mémoire tampon du cadre de destination pour l’image de sortie déblocée lorsque bPicDeblocked a la valeur 1. Ce membre n’a aucune signification et doit être égal à zéro si bPicDeblocked est égal à zéro. Ce membre peut être identique à wDecodedPictureIndex.

wForwardRefPictureIndex

Spécifie l’index de mémoire tampon d’image de l’image à utiliser comme image de référence pour la prédiction avant de l’image actuelle. Ne doit pas être identique à wDecodedPictureIndex. Ce membre doit être 0xFFFF si bPicIntra a la valeur 1.

wBackwardRefPictureIndex

Spécifie l’index de mémoire tampon d’image de l’image à utiliser comme image de référence pour la prédiction descendante de l’image actuelle. Ce membre ne doit pas être identique à wDecodedPictureIndex si la prédiction de mouvement de référence descendante est utilisée. Ce membre doit être 0xFFFF si bPicBackwardPrediction est égal à zéro.

wPicWidthInMBminus1

Spécifie la largeur de l’image actuelle en unités de macroblocks, moins 1. La largeur de l’image dans macroblocks est dérivée en ajoutant 1 à wPicWidthInMBminus1.

wPicHeightInMBminus1

Spécifie la hauteur de l’image actuelle en unités de macroblocks, moins 1. La hauteur de l’image dans macroblocks est dérivée en ajoutant 1 à wPicHeightInMBminus1.

bMacroblockWidthMinus1

Spécifie la largeur d’exemple de luminance de destination d’un macroblock, moins 1. Cette valeur est égale à 15 pour MPEG-1, MPEG-2, H.263 et MPEG-4.

bMacroblockHeightMinus1

Spécifie la hauteur d’exemple de luminance de destination d’un macroblock, moins 1. Cette valeur est égale à 15 pour MPEG-1, MPEG-2, H.261, H.263 et MPEG-4.

bBlockWidthMinus1

Spécifie la largeur de bloc d’un bloc de différence résiduelle moins 1. Cela est égal à 7 pour MPEG-1, MPEG-2, H.261, H.263 et MPEG-4. Il s’agit de 7 si le membre bConfig4GroupedCoefs de la structure DXVA_ConfigPictureDecode est 1. Les blocs de différence résiduelle dans un macroblock sont envoyés dans l’ordre spécifié comme dans MPEG-2 Figures 6-10, 6-11, et 6-12 (ordre raster-scan pour Y, suivi de tous les blocs 4 :2 :0 de Cb dans l’ordre raster-scan, suivi de 4 :2 :0 blocs de Cr, suivi de 4 :2 :2 blocs de Cb, suivi de 4 :2 :2 blocs de Cr, suivi de 4 :4 :4 :4 blocs de Cb, suivi de 4 :4 :4 blocs de Cr). Un terme dérivé appelé W_T est formé en ajoutant 1 à bBlockWidthMinus1.

bBlockHeightMinus1

Spécifie la hauteur de bloc d’un bloc de différence résiduelle, moins 1. Cela est égal à 7 pour MPEG-1, MPEG-2, H.261, H.263 et MPEG-4. Il s’agit de 7 si bConfig4GroupedCoefs a la valeur 1. Un terme dérivé appelé H_T est formé en ajoutant 1 à bBlockHeightMinus1.

bBPPminus1

Spécifie le nombre de bits par pixel pour les exemples de valeurs vidéo, moins 1. Il s’agit d’au moins 7 (indiquant des pixels 8 bits). Cette valeur est égale à 7 pour MPEG-1, MPEG-2, H.261 et H.263. Un plus grand nombre de bits par pixel est pris en charge dans certains modes opérationnels de MPEG-4. Un terme dérivé appelé BPP est formé en ajoutant 1 à bBPPminus1.

bPicStructure

Indique si l’image actuelle est une image de champ supérieur (valeur 1), une image de champ inférieur (valeur 2) ou une image de cadre (valeur 3). Dans le codage structuré par trame à analyse progressive, comme dans H.261, bPicStructure est 3. Une valeur dérivée PicCurrentField est définie comme zéro, sauf si bPicStructure est 2 (champ inférieur). Dans ce cas, il est 1. Ce membre a la même signification que la variable picture_structure définie dans la section 6.3.10 et le tableau 6-14 de MPEG-2 (H.262).

bSecondField

Indique si, dans le cas d’un codage structuré par un champ (lorsque bPicStructure a la valeur 1 ou 2), le champ actuel est le deuxième champ d’une image. Cela permet de déterminer si le champ de parité opposée utilisé comme référence pour les lignes de parité opposée pour la prédiction de compensation de mouvement est le champ de parité opposée de l’image de référence ou le champ de parité opposée de l’image actuelle. Si bSecondField a la valeur 1, le champ actuel est le deuxième champ d’une image et le champ utilisé comme référence pour les lignes de parité opposée pour la compensation de mouvement est les lignes de parité opposée de l’image actuelle. (Dans les deux cas, le champ utilisé comme référence pour les lignes de même parité pour la compensation de mouvement sont les mêmes lignes de parité de l’image de référence.) Sinon, bSecondField est égal à zéro.

bPicIntra

Indique si une prédiction compensée par le mouvement est nécessaire pour cette image. Si bPicIntra a la valeur 1, tous les macroblocks sont envoyés avec la DXVA_MBctrl_I_OffHostIDCT_1 ou DXVA_MBctrl_I_HostResidDiff_1 structure de commande de contrôle macroblock, dans laquelle l’indicateur IntraMacroblock est égal à 1 . Autrement dit, aucune prédiction compensée par le mouvement n’est effectuée pour l’image. Sinon, certains macroblocks de l’image peuvent avoir le paramètre IntraMacroblock de la commande de contrôle macroblock égal à zéro, et la structure de commandes de contrôle macroblock utilise la structure DXVA_MBctrl_P_HostResidDiff_1 ou la structure DXVA_MBctrl_P_OffHostIDCT_1 .

bPicBackwardPrediction

Indique si les macroblocks de l’image actuelle peuvent inclure une prédiction descendante. Si bPicIntra a la valeur 1, bPicBackwardPrediction doit être égal à zéro. Si bPicBackwardPrediction est égal à zéro, MotionBackward doit être égal à zéro dans toutes les commandes de contrôle macroblock de l’image (dans chaque structure DXVA_MBctrl_I_HostResidDiff_1, DXVA_MBctrl_I_OffHostIDCT_1, DXVA_MBctrl_P_HostResidDiff_1 ou DXVA_MBctrl_P_OffHostIDCT_1). Si bPicBackwardPrediction a la valeur 1, certains macroblocks de l’image peuvent avoir MotionBackward égal à 1.

bBidirectionalAveragingMode

Indique la méthode d’arrondi permettant de combiner des plans de prédiction dans une compensation de mouvement bidirectionnelle (utilisée pour les images B et les mouvements à double prime). La valeur zéro indique la moyenne arrondie MPEG-1 et MPEG-2 (dans laquelle les valeurs à mi-chemin entre deux entiers sont arrondies vers le haut à l’entier supérieur suivant), et la valeur 1 indique la moyenne tronquée H.263 (dans laquelle les valeurs à mi-chemin entre deux entiers sont arrondies vers le bas vers l’entier inférieur suivant). bBidirectionalAveragingMode doit être égal à zéro si aucune moyenne bidirectionnelle n’est nécessaire.

bMVprecisionAndChromaRelation

Ce membre indique la précision des vecteurs de mouvement de luminance et la façon dont les vecteurs de mouvement de chrominance sont dérivés des vecteurs de mouvement de luminance.

Le tableau suivant répertorie les valeurs de ce membre avec la précision du vecteur de mouvement de luminance spécifiée et une description de la façon dont les vecteurs de mouvement de chrominance sont dérivés.

bChromaFormat

Affecte le nombre de blocs d’erreur de prédiction attendus par l’accélérateur. Cette variable est définie dans MPEG-2 (H.262). Pour les flux de données MPEG-1, MPEG-2 Main Profile, H.261 et H.263, cette valeur doit toujours être définie sur 1, indiquant le format 4 :2 :0. Si la valeur est 2, cela indique 4 :2 :2, et si la valeur est 3, indique l’échantillonnage 4 :4 :4. Ce membre doit être égal à 1 si le membre bConfig4GroupedCoefs de DXVA_ConfigPictureDecode a la valeur 1 (car l’opération bConfig4GroupedCoefs n’inclut pas l’indication EOB nécessaire dans les données de coefficient aux formats 4 :2 :2 et 4 :4 :4).

bPicScanFixed

Lorsque vous utilisez un traitement IDCT basé sur un accélérateur de blocs de différence résiduels, la valeur 1 pour cet indicateur indique que la méthode d’analyse inverse est la même pour tous les macroblocks de l’image. La valeur zéro indique que ce n’est pas le cas. Ce membre doit être égal à 1 si le membre bConfigHostInverseScan est égal à 1 ou si le membre bConfigResidDiffAccelerator est égal à zéro dans DXVA_ConfigPictureDecode.

bPicScanMethod

Indique la méthode d’analyse inverse fixe pour l’image lorsque bPicScanFixed a la valeur 1. Lorsque bPicScanFixed a la valeur zéro, ce membre n’a aucune signification et doit avoir une valeur de zéro.

Si le membre bConfigHostInverseScan de DXVA_ConfigPictureDecode est égal à zéro, la méthode d’analyse définie par ce membre peut être l’une des suivantes.

Si le membre bConfigHostInverseScan de DXVA_ConfigPictureDecode est 1, la méthode d’analyse définie par bPicScanMethod doit être définie comme suit.

bPicReadbackRequests

Indique si des demandes de contrôle en lecture arrière sont émises pour l’image actuelle. La valeur 1 indique que les demandes de lecture arrière sont présentes et la valeur zéro indique qu’elles ne le sont pas. Les requêtes en lecture différée indiquent que les valeurs des macroblocks sont lues dans l’image décodée et déblocée finale (si le déblocage est appliqué avec wDeblockedPictureIndex égal à wDecodedPictureIndex).

bRcontrol

Définit la méthode d’arrondi à utiliser pour la compensation de mouvement d’un demi-échantillon. Cette variable est définie dans H.263, section 6.1.2. La valeur zéro indique la méthode d’arrondi d’un demi-échantillon trouvée dans MPEG-1, MPEG-2 et la première version de H.263. La valeur 1 indique la méthode d’arrondi qui inclut un biais de moyenne vers le bas qui peut être sélectionné dans certains modes facultatifs de H.263 et MPEG-4. Cela n’a aucun sens pour H.261, car H.261 n’a pas de compensation de mouvement à demi-échantillon. Il doit être défini sur zéro pour tous les flux de bits MPEG-1 et MPEG-2 afin de se conformer à l’opérateur d’arrondi défini par ces normes.

bPicSpatialResid8

Indique comment les blocs de différence de domaine spatial sont envoyés à l’accélérateur à partir de l’hôte. La valeur 1 indique que les blocs de différence de domaine spatial pour le décodage des différences résiduelles basées sur l’hôte peuvent être envoyés à l’aide d’exemples 8 bits, et une valeur de zéro indique qu’ils ne peuvent pas.

Ce membre doit être égal à zéro si le membre bConfigResidDiffHost de DXVA_ConfigPictureDecode est égal à zéro ou si BPP est supérieur à 8. Ce membre doit être 1 si BPP est 8, bPicIntra est 1 et bConfigResidDiffHost est 1. Ce membre doit être 1 si le membre bConfigSpatialResid8 de DXVA_ConfigPictureDecode est 1.

Si ce membre est égal à 1, les macroblocks intra de domaine spatial sont envoyés sous forme de valeurs 8 bits (qui sont signées ou non signées, comme déterminé par le membre bConfigIntraResidUnsigned de DXVA_ConfigPictureDecode), et les différences de macroblock non-intra de domaine spatial sont envoyées sous forme de valeurs de différence 8 bits signées par rapport à une prédiction compensée par le mouvement.

Le membre bPicSpatialResid8 diffère du membre bConfigSpatialResid8 de DXVA_ConfigPictureDecode en ce qu’il s’agit d’une indication pour une image particulière, et non d’une indication globale pour l’ensemble de la séquence vidéo. Dans certains cas, comme dans une image intra avec BPP égal à 8, bPicSpatialResid8 sera égal à 1 même si bConfigSpatialResid8 peut être égal à zéro.

bPicOverflowBlocks

Indique si les blocs de différence de domaine spatial sont envoyés à l’accélérateur à partir de l’hôte à l’aide de blocs de dépassement de capacité. La valeur 1 indique que les blocs de différence de domaine spatial pour le décodage de différence résiduelle basé sur l’hôte d’une image peuvent être envoyés à l’aide de blocs de dépassement de capacité. La valeur zéro indique que les blocs de différence de domaine spatial ne sont pas envoyés à l’aide de blocs de dépassement de capacité. Ce membre doit être égal à zéro si bConfigResidDiffHost est égal à zéro ou si bConfigSpatialResid8 est égal à zéro, ou si BPP est supérieur à 8. Les paramètres bConfigResidDiffHost et bConfigSpatialResid8 sont membres de DXVA_ConfigPictureDecode. bPicOverflowBlocks indique si des blocs de dépassement de capacité peuvent être présents pour l’image particulière. Dans une image intra avec un BPP égal à 8, bPicOverflowBlocks doit être égal à zéro, car aucun bloc de dépassement de capacité n’est nécessaire dans ce cas.

bPicExtrapolation

Indique si les vecteurs de mouvement au-dessus des limites d’image sont autorisés comme spécifié par H.263 Annexe D et MPEG-4. Cela nécessite l’allocation de plans d’image qui sont plus larges (un macroblock supplémentaire à gauche et un autre à droite) et deux macroblocks plus hauts (un macroblock supplémentaire en haut et un autre en bas) que la taille de l’image décodée, ou un découpage de l’adresse de chaque pixel individuel à l’intérieur des limites de l’image. Les adresses macroblock de cette spécification sont destinées aux macroblocks à l’intérieur de l’image, sans inclure le remplissage.

bPicDeblocked

Indique si des commandes de déblocage sont envoyées pour cette image afin de créer une image de sortie déblocée. L’image de sortie déblocée est placée dans la mémoire tampon d’image indiquée par wDeblockedPictureIndex. Si bPicDeblocked a la valeur 1, des commandes de déblocage sont envoyées et le frame déblocé est généré. Si bPicDeblocked est égal à zéro, aucune commande de déblocage n’est envoyée et aucune image déblocée n’est générée.

bPicDeblockConfined

Indique si le déblocage des mémoires tampons de commande de filtre limite l’effet du déblocage des opérations de filtre à l’ensemble de macroblocks contenus dans la mémoire tampon de commande de filtrage de déblocage.

bPic4MVallowed

Spécifie si quatre vecteurs de mouvement de référence avant par macroblock sont autorisés, comme indiqué dans les annexes F et J de H.263.

bPicOBMC

Spécifie si la compensation de mouvement pour l’image actuelle fonctionne à l’aide de la compensation de mouvement de bloc (OBMC) superposée, comme indiqué dans l’annexe F H.263. Doit être égale à zéro si bPic4MVallowed est égal à zéro.

bPicBinPB

Spécifie si les macroblocks prédits de manière bidirectionnelle dans l’image utilisent B-picture dans la compensation de mouvement pb-frame. Cela limite la zone prédite de manière bidirectionnelle pour chaque macroblock à la région du macroblock correspondant dans l’image de référence descendante, comme spécifié dans les annexes G et M de H.263.

bMV_RPS

Spécifie l’utilisation de la sélection d’images de référence de vecteur de mouvement. Si bMV_RPS a la valeur 1, cela indique qu’un index d’image de référence est envoyé pour chaque vecteur de mouvement plutôt que simplement des index d’images animées vers l’avant et éventuellement vers l’arrière pour l’ensemble de l’image. Si bMV_RPS a la valeur 1, les membres wForwardRefPictureIndex et wBackwardRefPictureIndex n’ont aucune signification et doivent être zéro.

bReservedBits

Cette option est réservée à l’emballage et à l’alignement. Doit être zéro.

wBitstreamFcodes

Indique le vecteur de mouvement f_code valeurs telles que définies dans MPEG-2 pour le traitement de flux binaire brut. Chaque valeur f_code prend 4 bits. Ces valeurs sont regroupées dans un mot 16 bits comme suit.

Lorsque le membre bConfigBitstreamRaw de la structure DXVA_ConfigPictureDecode est 1, wBitstreamFcodes contient quatre vecteursde mouvement f_code valeurs. Si bConfigBitstreamRaw a la valeur 1 et que l’une des quatre valeurs f_code est inutile ou non pertinente en raison de la structure des données de flux de bits ou en raison de la valeur f_code n’est pas nécessaire dans la syntaxe de flux binaire de codage vidéo pertinente (par exemple, dans H.261 ou H.263), chaque valeur de f_code non pertinente est 0xF.

Si le membre bConfigBitstreamRaw de la structure DXVA_ConfigPictureDecode est égal à zéro, wBitstreamFcodes est défini sur 0xFFFF (toutes les valeurs f_code sont définies sur 0xF).

wBitstreamPCEelements

Lorsque le membre bConfigBitstreamRaw de DXVA_ConfigPictureDecode est 1, ce membre contient un ensemble d’indicateurs nécessaires pour le processus de décodage du flux de bits de la vidéo MPEG-2. Il n’est pas utilisé et doit être égal à zéro lorsque bConfigBitstreamRaw est égal à zéro et pour la vidéo non MPEG-2. Les bits de ce membre sont définis par leur correspondance avec les éléments bitstream de l’extension de codage d’image MPEG-2 comme suit.

bBitstreamConcealmentNeed

Indique la probabilité d’erreurs dans les données de flux de bits lorsque le membre bConfigBitstreamRaw de la structure DXVA_ConfigPictureDecode est 1. Doit être égal à zéro si bConfigBitstreamRaw est égal à zéro.

Les accélérateurs vidéo doivent être conçus pour ne pas échouer ou verrouiller, quel que soit le contenu des données qui leur sont données. Par conséquent, il peut être utile pour un accélérateur vidéo d’avoir des informations sur l’évaluation par l’hôte de la probabilité d’erreurs syntaxiques. Ceci permet de déterminer s’il est nécessaire d’appeler un algorithme de dissimulation d’erreur plus complexe susceptible de ralentir le processus de décodage du flux binaire. Les valeurs autorisées pour ce membre sont les suivantes (toutes les autres valeurs sont réservées).

bBitstreamConcealmentMethod

Spécifie une méthode par défaut préférée pour le traitement de la dissimulation des erreurs lorsque le membre bConfigBitstreamRaw de la structure DXVA_ConfigPictureDecode est 1. Doit être égal à zéro si bConfigBitstreamRaw est égal à zéro. Les valeurs autorisées pour ce membre sont les suivantes (toutes les autres valeurs sont réservées).

Remarques

Certains membres de cette structure sont limités à des valeurs spécifiques par la configuration établie à l’aide de la structure DXVA_ConfigPictureDecode . Une fois les paramètres au niveau de l’image transmis à l’aide de DXVA_PictureParameters, le processus de décodage d’image est principalement régi par des commandes de contrôle macroblock formées à l’aide des structures DXVA_MBctrl_I_HostResidDiff_1, DXVA_MBctrl_I_OffHostIDCT_1, DXVA_MBctrl_P_HostResidDiff_1 ou DXVA_MBctrl_P_OffHostIDCT_1 .

Configuration requise

Voir aussi

DXVA_ConfigPictureDecode

DXVA_MBctrl_I_HostResidDiff_1

DXVA_MBctrl_I_OffHostIDCT_1

DXVA_MBctrl_P_HostResidDiff_1

DXVA_MBctrl_P_OffHostIDCT_1