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;
Angehörige
[in] hSrcResource
Ein Handle für die Quellressource, die die Quelloberfläche enthält. Wenn die Oberfläche erstellt wird, empfängt der Anzeigetreiber für den Benutzermodus den D3DDDIFMT_A1 -Wert (ein Bit pro Pixel) im Format Member und das TextApi Bitfeldkennzeichnung im Flags Member 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 zur 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 Mitglied 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- Bitfeld-Flag erstellt.
[in] DstSubResourceIndex
Der Index zur Zieloberfläche innerhalb der Zielressource.
[in] hSrcRectDescsVB
Ein Handle zu einem 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 für den Benutzermodus das TextApi- Bitfeld-Flag im Flags-Element 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, die durch das hDstRectDescsVB Member identifiziert wird. Treiber sollten Aufrufe von ComposeRects ignorieren, wobei NumRects auf größer als 0xFFFF festgelegt sind.
[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 für den Benutzermodus das TextApi- Bitfeld-Flag im Flags-Element 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. Dieses Element kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
| D3DDDICOMPOSERECTS_COPY | Kopieren Sie jedes Quellbit auf das Ziel. |
| D3DDDICOMPOSERECTS_OR | Kombinieren Sie Quell- und Zielbits in einem OR-Vorgang, und kopieren Sie es an das Ziel. |
| D3DDDICOMPOSERECTS_AND | Kombinieren Sie Quell- und Zielbits in einem AND-Vorgang, und kopieren Sie es an 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 der 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 der 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.
Bemerkungen
Die Vertexpuffer, die die Erstellungsanweisungen 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dumddi.h (include D3dumddi.h) |