structure D3DDDIARG_COMPOSERECTS (d3dumddi.h)

Article
02/06/2025

La structure D3DDDIARG_COMPOSERECTS décrit les paramètres utilisés pour composer des zones rectangulaires.

Syntaxe

typedef struct _D3DDDIARG_COMPOSERECTS {
  [in] HANDLE                hSrcResource;
  [in] UINT                  SrcSubResourceIndex;
  [in] HANDLE                hDstResource;
  [in] UINT                  DstSubResourceIndex;
  [in] HANDLE                hSrcRectDescsVB;
  [in] UINT                  NumRects;
  [in] HANDLE                hDstRectDescsVB;
  [in] D3DDDI_COMPOSERECTSOP Operation;
  [in] INT                   XOffset;
  [in] INT                   YOffset;
} D3DDDIARG_COMPOSERECTS;

Membres

[in] hSrcResource

Handle vers la ressource source qui contient l’aire source. Lorsque l’aire est créée, le pilote d’affichage en mode utilisateur reçoit la valeur D3DDDIFMT_A1 (un bit par pixel) dans le membre Format et l’indicateur de champ de TextApi dans l’indicateur de membre de la structure de D3DDDIARG_CREATERESOURCE dans un appel à la fonction CreateResource du pilote. La surface doit être créée dans le cadre d’une texture.

[in] SrcSubResourceIndex

Index de la surface source dans la ressource source.

[in] hDstResource

Handle de la ressource de destination qui contient l’aire de destination. Lorsque la surface est créée, le pilote d’affichage en mode utilisateur reçoit la valeur D3DDDIFMT_A1 (un bit par pixel) dans le membre Format de D3DDDIARG_CREATERESOURCE dans un appel au CreateResourcedu pilote. La surface doit être créée dans le cadre d’une texture. La surface a peut-être été créée avec l’indicateur TextApi bit-field.

[in] DstSubResourceIndex

Index de la surface de destination dans la ressource de destination.

[in] hSrcRectDescsVB

Handle vers une mémoire tampon de vertex qui contient un tableau de structures D3DCOMPOSERECTSRCDESC. Chaque élément du tableau définit un rectangle sur l’aire source. Lorsque la mémoire tampon de vertex est créée, le pilote d’affichage en mode utilisateur reçoit l’indicateur TextApi champ bit dans le Indicateurs membre de la structure D3DDDIARG_CREATERESOURCE dans un appel à la fonction CreateResource du pilote.

[in] NumRects

Nombre de zones rectangulaires à copier, qui correspond au nombre de structures D3DCOMPOSERECTDSTDESC dans la mémoire tampon de vertex identifiée par le membre hDstRectDescsVB. Les pilotes doivent ignorer les appels à ComposeRects avec numRects défini sur supérieur à 0xFFFF.

[in] hDstRectDescsVB

Handle vers une mémoire tampon de vertex qui contient un tableau de structures D3DCOMPOSERECTDSTDESC. Chaque élément du tableau définit où copier un rectangle source sur l’aire de destination. Pour plus d’informations, consultez la section Remarques suivante. Lorsque la mémoire tampon de vertex est créée, le pilote d’affichage en mode utilisateur reçoit l’indicateur TextApi champ bit dans le Indicateurs membre de la structure D3DDDIARG_CREATERESOURCE dans un appel à la fonction CreateResource du pilote.

[in] Operation

Valeur D3DDDI_COMPOSERECTSOP qui décrit comment composer les zones rectangulaires. Ce membre peut être l’une des valeurs suivantes.

valeur	Signification
D3DDDICOMPOSERECTS_COPY	Copiez chaque bit source vers la destination.
D3DDDICOMPOSERECTS_OR	Combinez les bits source et de destination dans une opération OR et copiez-les vers la destination.
D3DDDICOMPOSERECTS_AND	Combinez les bits source et de destination dans une opération AND et copiez-les vers la destination.
D3DDDICOMPOSERECTS_NEG	Combinez le négatif des bits sources avec les bits de destination et copiez-les vers la destination. [Dest bit & (~ Src bit)]

[in] XOffset

Décalage à ajouter au x-coordonnées de toutes les zones rectangulaires de destination. Le décalage peut être négatif, ce qui peut entraîner le rejet ou le découpage des rectangles résultants.

[in] YOffset

Décalage à ajouter à la y-coordonnées de toutes les zones rectangulaires de destination. Le décalage peut être négatif, ce qui peut entraîner le rejet ou le découpage des rectangles résultants.

Remarques

Les mémoires tampons de vertex qui contiennent les instructions de composition sont créées avec D3DUSAGE_TEXTAPI utilisation. Le code suivant définit les structures contenues dans les tableaux de mémoires tampons de vertex. Pour plus d’informations sur ces structures, consultez la documentation du Kit de développement logiciel (SDK) DirectX.

struct D3DCOMPOSERECTSRCDESC {
USHORT X, Y;          // Coordinates of top-left corner
USHORT width, height; // Width and height of the glyph in bits
};

struct D3DCOMPOSERECTDSTDESC {
USHORT RectDescIndex; // Index of one of the D3DCOMPOSERECTSRCDESC structures in the vertex buffer represented by hSrcRectDescsVB
USHORT reserved;      // Use to align the struct and fields to good boundaries
SHORT X, Y;            // Position in bits in the destination surface
};

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête	d3dumddi.h (include D3dumddi.h)

Voir aussi

ComposeRects

RECT

Partager via