struttura D3DDDIARG_COMPOSERECTS (d3dumddi.h)

Articolo
02/06/2025

La struttura D3DDDIARG_COMPOSERECTS descrive i parametri utilizzati per comporre aree rettangolari.

Sintassi

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;

Membri

[in] hSrcResource

Handle per la risorsa di origine che contiene la superficie di origine. Quando viene creata la superficie, il driver di visualizzazione in modalità utente riceve il valore di D3DDDIFMT_A1 (un bit per pixel) nel membro Format e il flag TextApi campo di bit nel Flags membro della struttura D3DDDIARG_CREATERESOURCE in una chiamata alla funzione CreateResource del driver. La superficie deve essere creata come parte di una trama.

[in] SrcSubResourceIndex

Indice della superficie di origine all'interno della risorsa di origine.

[in] hDstResource

Handle per la risorsa di destinazione che contiene la superficie di destinazione. Quando viene creata la superficie, il driver di visualizzazione in modalità utente riceve il valore di D3DDDIFMT_A1 (un bit per pixel) nel membro Format di D3DDDIARG_CREATERESOURCE in una chiamata al CreateResource del driver. La superficie deve essere creata come parte di una trama. È possibile che la superficie sia stata creata con il flag TextApi campo di bit.

[in] DstSubResourceIndex

Indice della superficie di destinazione all'interno della risorsa di destinazione.

[in] hSrcRectDescsVB

Handle per un buffer dei vertici che contiene una matrice di strutture D3DCOMPOSERECTSRCDESC. Ogni elemento nella matrice definisce un rettangolo sulla superficie di origine. Quando viene creato il buffer dei vertici, il driver di visualizzazione in modalità utente riceve il flag TextApi campo di bit nel Flags membro della struttura D3DDDIARG_CREATERESOURCE in una chiamata alla funzione CreateResource del driver.

[in] NumRects

Numero di aree rettangolari da copiare, ovvero il numero di strutture D3DCOMPOSERECTDSTDESC nel buffer dei vertici identificato dal membro hDstRectDescsVB. I driver devono ignorare le chiamate a ComposeRects con NumRects impostato su maggiore di 0xFFFF.

[in] hDstRectDescsVB

Handle per un buffer dei vertici che contiene una matrice di strutture D3DCOMPOSERECTDSTDESC. Ogni elemento della matrice definisce dove copiare un rettangolo di origine sulla superficie di destinazione. Per altre informazioni, vedere la sezione Osservazioni seguente. Quando viene creato il buffer dei vertici, il driver di visualizzazione in modalità utente riceve il flag TextApi campo di bit nel Flags membro della struttura D3DDDIARG_CREATERESOURCE in una chiamata alla funzione CreateResource del driver.

[in] Operation

Valore D3DDDI_COMPOSERECTSOP che descrive come comporre le aree rettangolari. Questo membro può essere uno dei valori seguenti.

valore	significato
D3DDDICOMPOSERECTS_COPY	Copiare ogni bit di origine nella destinazione.
D3DDDICOMPOSERECTS_OR	Combinare i bit di origine e di destinazione in un'operazione OR e copiarlo nella destinazione.
D3DDDICOMPOSERECTS_AND	Combinare i bit di origine e di destinazione in un'operazione AND e copiare nella destinazione.
D3DDDICOMPOSERECTS_NEG	Combinare il valore negativo dei bit di origine con i bit di destinazione e copiarlo nella destinazione. [Dest bit & (~ Src bit)]

[in] XOffset

Offset da aggiungere alla xcoordinate di tutte le aree rettangolari di destinazione. L'offset può essere negativo, che potrebbe causare il rifiuto o il ritaglio dei rettangoli risultanti.

[in] YOffset

Offset da aggiungere alla ycoordinate di tutte le aree rettangolari di destinazione. L'offset può essere negativo, che potrebbe causare il rifiuto o il ritaglio dei rettangoli risultanti.

Osservazioni

I vertex buffer che contengono le istruzioni di composizione vengono creati con D3DUSAGE_TEXTAPI utilizzo. Il codice seguente definisce le strutture contenute nelle matrici di buffer dei vertici. Per altre informazioni su queste strutture, vedere la documentazione di DirectX SDK.

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
};

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
intestazione	d3dumddi.h (include D3dumddi.h)

Vedere anche

ComposeRects

RECT

Condividi tramite