estructura D3DDDIARG_COMPOSERECTS (d3dumddi.h)

La estructura D3DDDIARG_COMPOSERECTS describe los parámetros que se usan para componer áreas rectangulares.

Sintaxis

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;

Miembros

[in] hSrcResource

Identificador del recurso de origen que contiene la superficie de origen. Cuando se crea la superficie, el controlador de pantalla en modo de usuario recibe el valor de D3DDDIFMT_A1 (un bit por píxel) en el miembro Format y la marca de campo de bits TextApi en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource del controlador. La superficie debe crearse como parte de una textura.

[in] SrcSubResourceIndex

Índice de la superficie de origen dentro del recurso de origen.

[in] hDstResource

Identificador del recurso de destino que contiene la superficie de destino. Cuando se crea la superficie, el controlador de pantalla en modo de usuario recibe el valor de D3DDDIFMT_A1 (un bit por píxel) en el miembro Format de D3DDDIARG_CREATERESOURCE en una llamada al createResource del controlador. La superficie debe crearse como parte de una textura. Es posible que la superficie se haya creado con la marca de campo de bits TextApi .

[in] DstSubResourceIndex

Índice de la superficie de destino dentro del recurso de destino.

[in] hSrcRectDescsVB

Identificador de un búfer de vértices que contiene una matriz de estructuras de D3DCOMPOSERECTSRCDESC. Cada elemento de la matriz define un rectángulo en la superficie de origen. Cuando se crea el búfer de vértices, el controlador de pantalla en modo de usuario recibe la marca de campo de bits TextApi en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource del controlador.

[in] NumRects

Número de áreas rectangulares que se van a copiar, que es el número de estructuras de D3DCOMPOSERECTDSTDESC en el búfer de vértices identificado por el miembro hDstRectDescsVB . Los controladores deben omitir las llamadas a ComposeRects con NumRects establecido en mayor que 0xFFFF.

[in] hDstRectDescsVB

Identificador de un búfer de vértices que contiene una matriz de estructuras de D3DCOMPOSERECTDSTDESC. Cada elemento de la matriz define dónde copiar un rectángulo de origen en la superficie de destino. Para obtener más información, vea la sección Comentarios que se muestra más adelante. Cuando se crea el búfer de vértices, el controlador de pantalla en modo de usuario recibe la marca de campo de bits TextApi en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource del controlador.

[in] Operation

Valor de D3DDDI_COMPOSERECTSOP que describe cómo componer las áreas rectangulares. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
D3DDDICOMPOSERECTS_COPY	Copie cada bit de origen en el destino.
D3DDDICOMPOSERECTS_OR	Combine bits de origen y destino en una operación OR y copie en el destino.
D3DDDICOMPOSERECTS_AND	Combine bits de origen y destino en una operación AND y copie en el destino.
D3DDDICOMPOSERECTS_NEG	Combine el negativo de los bits de origen con los bits de destino y copie en el destino. [Dest bit & (~ Src bit)]

[in] XOffset

Desplazamiento que se va a agregar a las coordenadas x de todas las áreas rectangulares de destino. El desplazamiento puede ser negativo, lo que puede hacer que los rectángulos resultantes se rechacen o se recorten.

[in] YOffset

Desplazamiento que se va a agregar a las coordenadas y de todas las áreas rectangulares de destino. El desplazamiento puede ser negativo, lo que puede hacer que los rectángulos resultantes se rechacen o se recorten.

Comentarios

Los búferes de vértices que contienen las instrucciones de redacción se crean con D3DUSAGE_TEXTAPI uso. El código siguiente define las estructuras contenidas en las matrices de búfer de vértices. Para obtener más información sobre estas estructuras, consulte la documentación del SDK de 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
};

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

ComposeRects

RECT