D3DDDIARG_COPYFLAGS Struktur (d3dumddi.h)
Beschreibt, wie der vorhandene Inhalt einer Ressource während eines Kopier- oder Aktualisierungsvorgangs einer Region innerhalb dieser Ressource behandelt wird. Wird von Windows Display Driver Model (WDDM) 1.3 und höher von Anzeigetreibern für den Benutzermodus verwendet.
Syntax
typedef struct D3DDDIARG_COPYFLAGS {
union {
struct {
UINT NoOverwrite : 1;
UINT Discard : 1;
UINT Reserved1 : 22;
UINT BoxValid : 1;
UINT Reserved2 : 7;
};
UINT Value;
};
} D3DDDIARG_COPYFLAGS;
Angehörige
NoOverwrite
Gibt an, dass der Aufrufer garantiert, dass der Teil der Oberfläche, in die mit neuen Daten geschrieben wird, derzeit nicht von einem vorherigen Rendervorgang referenziert oder darauf zugegriffen wird. Der Treiber kann diese Funktion nutzen, um die Leistung und speicherauslastung zu optimieren.
Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Value Members (0x00000001).
Discard
Gibt an, dass der Anzeigetreiber für den Benutzermodus vorherige Inhalte der gesamten Ressource verwerfen kann. Der Treiber kann diese Funktion nutzen, um die Leistung und speicherauslastung zu optimieren.
Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Value Members (0x00000002).
Reserved1
Dieses Element ist reserviert und sollte auf Null festgelegt werden.
Das Festlegen dieses Elements auf Null entspricht dem Festlegen von Bits 3 bis 24 (0x00FFFFFC) des 32-Bit-Werts Member auf Nullen.
BoxValid
Gibt an, dass ein Zielbereich der zu kopierenden Unterressource gültig ist. Wenn sie nicht festgelegt ist, muss die gesamte Unterressource aktualisiert werden.
Das Festlegen dieses Elements entspricht dem Festlegen des 32-Bit-Value Members (0x01000000).
Reserved2
Dieses Element ist reserviert und sollte auf Null festgelegt werden.
Das Festlegen dieses Elements auf Null entspricht dem Festlegen von Bits 26 bis 32 (0xFE000000) des 32-Bit-Werts Members auf Nullen.
Value
Ein Mitglied in der Union, das D3DDDIARG_COPYFLAGS enthält, die einen 32-Bit-Wert enthalten können, der angibt, wie der vorhandene Inhalt einer Ressource während eines Kopier- oder Aktualisierungsvorgangs behandelt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Header- | d3dumddi.h (include D3d10umddi.h) |