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 für Benutzermodus-Anzeigetreiber 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;

Member

NoOverwrite

Gibt an, dass der Aufrufer garantiert, dass auf den Teil der Oberfläche, auf den mit neuen Daten geschrieben wird, derzeit nicht von einem vorherigen Rendervorgang verwiesen wird oder darauf zugegriffen wird. Der Treiber kann diese Funktion nutzen, um die Leistung und Die Speicherauslastung zu optimieren.

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Elements Wert (0x00000001).

Discard

Gibt an, dass der Benutzermodusanzeigetreiber vorherige Inhalte der gesamten Ressource verwerfen kann. Der Treiber kann diese Funktion nutzen, um die Leistung und Die Speicherauslastung zu optimieren.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Wertmembers (0x00000002).

Reserved1

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

Das Festlegen dieses Elements auf 0 (null) entspricht dem Festlegen der Bits 3 bis 24 (0x00FFFFFC) des 32-Bit-Wertmembers 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 fünfundzwanzigten Bits des 32-Bit-Elements Wert (0x01000000).

Reserved2

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

Das Festlegen dieses Elements auf 0 (null) entspricht dem Festlegen der Bits 26 bis 32 (0xFE000000) des 32-Bit-Wertmembers auf Nullen.

Value

Ein Element in der Union, das D3DDDIARG_COPYFLAGS enthält, das einen 32-Bit-Wert enthalten kann, der angibt, wie der vorhandene Inhalt einer Ressource während eines Kopier- oder Aktualisierungsvorgangs behandelt wird.

Anforderungen

Weitere Informationen

D3DDDIARG_UPDATESUBRESOURCEUP