D3DDDIARG_COMPOSERECTS-Struktur (d3dumddi.h)
Die D3DDDIARG_COMPOSERECTS-Struktur beschreibt die Parameter, die zum Verfassen rechteckiger Bereiche verwendet werden.
Syntax
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;
Member
[in] hSrcResource
Ein Handle für die Quellressource, die die Quelloberfläche enthält. Wenn die Oberfläche erstellt wird, empfängt der Benutzermodusanzeigetreiber den D3DDDIFMT_A1-Wert (ein Bit pro Pixel) im Format-Element und das TextApi-Bitfeldflag im Flags-Element der D3DDDIARG_CREATERESOURCE-Struktur in einem Aufruf der CreateResource-Funktion des Treibers. Die Oberfläche muss als Teil einer Textur erstellt werden.
[in] SrcSubResourceIndex
Der Index für die Quelloberfläche innerhalb der Quellressource.
[in] hDstResource
Ein Handle für die Zielressource, die die Zieloberfläche enthält. Wenn die Oberfläche erstellt wird, empfängt der Benutzermodusanzeigetreiber den D3DDDIFMT_A1 -Wert (ein Bit pro Pixel) im Format-Member von D3DDDIARG_CREATERESOURCE in einem Aufruf der CreateResource des Treibers. Die Oberfläche muss als Teil einer Textur erstellt werden. Die Oberfläche wurde möglicherweise mit dem TextApi-Bitfeldflag erstellt.
[in] DstSubResourceIndex
Der Index für die Zieloberfläche innerhalb der Zielressource.
[in] hSrcRectDescsVB
Ein Handle für einen Vertexpuffer, der ein Array von D3DCOMPOSERECTSRCDESC Strukturen enthält. Jedes Element im Array definiert ein Rechteck auf der Quelloberfläche. Wenn der Vertexpuffer erstellt wird, empfängt der Anzeigetreiber im Benutzermodus das TextApi-Bitfeldflag im Flags-Member der D3DDDIARG_CREATERESOURCE-Struktur in einem Aufruf der CreateResource-Funktion des Treibers.
[in] NumRects
Die Anzahl der zu kopierenden rechteckigen Bereiche, d. h. die Anzahl der D3DCOMPOSERECTDSTDESC Strukturen im Vertexpuffer, der vom hDstRectDescsVB-Element identifiziert wird. Treiber sollten Aufrufe von ComposeRects ignorieren, wobei NumRects auf größer als 0xFFFF festgelegt ist.
[in] hDstRectDescsVB
Ein Handle für einen Vertexpuffer, der ein Array von D3DCOMPOSERECTDSTDESC Strukturen enthält. Jedes Element im Array definiert, wo ein Quellrechteck auf der Zieloberfläche kopiert werden soll. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise". Wenn der Vertexpuffer erstellt wird, empfängt der Anzeigetreiber im Benutzermodus das TextApi-Bitfeldflag im Flags-Member der D3DDDIARG_CREATERESOURCE-Struktur in einem Aufruf der CreateResource-Funktion des Treibers.
[in] Operation
Ein D3DDDI_COMPOSERECTSOP Wert, der beschreibt, wie die rechteckigen Bereiche erstellt werden. Dieser Member kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
| D3DDDICOMPOSERECTS_COPY | Kopieren Sie jedes Quellbit in das Ziel. |
| D3DDDICOMPOSERECTS_OR | Kombinieren Sie Quell- und Zielbits in einem OR-Vorgang, und kopieren Sie sie in das Ziel. |
| D3DDDICOMPOSERECTS_AND | Kombinieren Sie Quell- und Zielbits in einem AND-Vorgang, und kopieren Sie sie in das Ziel. |
| D3DDDICOMPOSERECTS_NEG | Kombinieren Sie das Negative der Quellbits mit den Zielbits, und kopieren Sie sie in das Ziel. [Dest bit & (~ Src bit)] |
[in] XOffset
Ein Offset, der den X-Koordinaten aller rechteckigen Zielbereiche hinzugefügt werden soll. Der Offset kann negativ sein, was dazu führen kann, dass die resultierenden Rechtecke abgelehnt oder abgeschnitten werden.
[in] YOffset
Ein Offset, der den y-Koordinaten aller rechteckigen Zielbereiche hinzugefügt werden soll. Der Offset kann negativ sein, was dazu führen kann, dass die resultierenden Rechtecke abgelehnt oder abgeschnitten werden.
Hinweise
Die Vertexpuffer, die die Komponierungsanweisungen enthalten, werden mit D3DUSAGE_TEXTAPI Verwendung erstellt. Der folgende Code definiert die Strukturen, die in den Vertexpufferarrays enthalten sind. Weitere Informationen zu diesen Strukturen finden Sie in der DirectX SDK-Dokumentation.
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
};
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |