D3DDDIARG_COMPOSERECTS structure (d3dumddi.h)

  • Article

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 de la ressource source qui contient la surface source. 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 et l’indicateur de champ binaire TextApi dans le membre Indicateurs de la structure 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 CreateResource du pilote. La surface doit être créée dans le cadre d’une texture. La surface a peut-être été créée avec l’indicateur de champ binaire TextApi .

[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 la surface source. Lorsque la mémoire tampon de vertex est créée, le pilote d’affichage en mode utilisateur reçoit l’indicateur de champ binaire TextApi dans le membre Indicateurs 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 l’emplacement où copier un rectangle source sur la surface de destination. Pour plus d'informations, consultez la section Notes qui suit. Lorsque la mémoire tampon de vertex est créée, le pilote d’affichage en mode utilisateur reçoit l’indicateur de champ binaire TextApi dans le membre Indicateurs 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 & (~ bit Src)]

[in] XOffset

Décalage à ajouter aux coordonnées x 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 aux coordonnées y 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
};

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

ComposeRects

RECT