D3DDDIARG_COMPOSERECTS struttura (d3dumddi.h)

La struttura D3DDDIARG_COMPOSERECTS descrive i parametri usati 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;

Members

[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 nel flag di campo a bit TextApi nel membro Flagdella struttura D3DDDIARG_CREATERESOURCE in una chiamata alla funzione CreateResource del driver. La superficie deve essere creata come parte di una trama.

[in] SrcSubResourceIndex

Indice dell'area di origine all'interno della risorsa di origine.

[in] hDstResource

Handle alla risorsa di destinazione contenente 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 a CreateResource del driver. La superficie deve essere creata come parte di una trama. La superficie potrebbe essere stata creata con il flag di campo a bit TextApi .

[in] DstSubResourceIndex

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

[in] hSrcRectDescsVB

Handle a un buffer del vertice che contiene una matrice di strutture D3DCOMPOSERECTSRCDESC. Ogni elemento della 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 di campo di bit TextApi nel membro Flag 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 del vertice identificato dal membro hDstRectDescsVB . I driver devono ignorare le chiamate a ComposeRects con NumRects impostate su più di 0xFFFF.

[in] hDstRectDescsVB

Handle in un buffer del vertice che contiene una matrice di strutture D3DCOMPOSERECTDSTDESC. Ogni elemento della matrice definisce dove copiare un rettangolo di origine nell'area di destinazione. Per ulteriori informazioni, vedere la sezione Osservazioni successiva. Quando viene creato il buffer dei vertici, il driver di visualizzazione in modalità utente riceve il flag di campo di bit TextApi nel membro Flag 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 bit di origine e destinazione in un'operazione OR e copiare nella destinazione.
D3DDDICOMPOSERECTS_AND	Combinare bit di origine e 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 copiare nella destinazione. [Dest bit & (~ Src bit)]

[in] XOffset

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

[in] YOffset

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

Commenti

I buffer dei vertici che contengono le istruzioni di composizione vengono creati con D3DUSAGE_TEXTAPI utilizzo. Il codice seguente definisce le strutture contenute nelle matrici del 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
};

Requisiti

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

Vedi anche

ComposeRects

RECT