D3DDDI_LOCKFLAGS Struktur (d3dumddi.h)

Die D3DDDI_LOCKFLAGS-Struktur gibt an, wie eine Ressource gesperrt wird.

Syntax

typedef struct _D3DDDI_LOCKFLAGS {
  union {
    struct {
      UINT ReadOnly : 1;
      UINT WriteOnly : 1;
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT RangeValid : 1;
      UINT AreaValid : 1;
      UINT BoxValid : 1;
      UINT NotifyOnly : 1;
      UINT MightDrawFromLocked : 1;
      UINT DoNotWait : 1;
      UINT Reserved : 22;
    };
    UINT Value;
  };
} D3DDDI_LOCKFLAGS;

Member

ReadOnly

Ein UINT-Wert, der angibt, ob die gesperrte Ressource nur aus gelesen werden kann. Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Wertmembers (0x00000001).

WriteOnly

Ein UINT-Wert, der angibt, ob die gesperrte Ressource nur in geschrieben werden kann. Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Wertmembers (0x00000002).

NoOverwrite

Ein UINT-Wert, der angibt, ob der gesperrten Ressource Daten angefügt werden können, die vorhandenen Daten in der Ressource jedoch nicht geändert werden können. Dieses Element wird nur mit Direct3D-Vertexpuffersperren verwendet.

Das Festlegen dieses Members entspricht dem Festlegen des dritten Bits des 32-Bit-Wertmembers (0x00000004).

Discard

Ein UINT-Wert, der angibt, ob die gesamte gesperrte Ressource geändert wird. Da die vorhandenen Inhalte verworfen werden können, müssen sie daher nicht vorab verarbeitet werden.

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

RangeValid

Ein UINT-Wert, der angibt, ob die gesperrte Ressource linear ist.

Das Festlegen dieses Members entspricht dem Festlegen des fünften Bits des 32-Bit-Wertmembers (0x00000010).

AreaValid

Ein UINT-Wert, der angibt, ob es sich bei der gesperrten Ressource um eine Oberfläche handelt.

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

BoxValid

Ein UINT-Wert, der angibt, ob es sich bei der gesperrten Ressource um ein Volume handelt.

Das Festlegen dieses Members entspricht dem Festlegen des siebten Bits des 32-Bit-Wertmembers (0x00000040).

NotifyOnly

Ein UINT-Wert, der angibt, ob der Sperraufruf nur für Benachrichtigungen bestimmt ist.

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

MightDrawFromLocked

Ein UINT-Wert, der angibt, ob der Treiber möglicherweise aufgefordert wird, aus einem Vertexpuffer zu zeichnen, auch wenn der Scheitelpunktpuffer von der Direct3D-Runtime gesperrt ist. MightDrawFromLocked garantiert nicht, dass der Treiber nach dem Aufruf von Lock Aufrufe der Funktionen DrawIndexedPrimitive, DrawIndexedPrimitive2, DrawPrimitive und DrawPrimitive2 empfängt. MightDrawFromLocked wird nur für Vertexpuffer festgelegt, die während der Erstellungszeit mit dem Bitfeldflag MightDrawFromLocked im Flags-Element der D3DDDIARG_CREATERESOURCE-Struktur erstellt wurden.

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

DoNotWait

Ein UINT-Wert, der angibt, ob der Benutzermodusanzeigetreiber auf den Leerlauf der Ressource warten soll. Das Festlegen von DoNotWait gibt an, dass der Benutzermodusanzeigetreiber nicht warten sollte, bis die Ressource im Leerlauf ist.

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

Reserved

Dieser Member ist reserviert und sollte auf null festgelegt werden. Das Festlegen dieses Elements auf 0 entspricht dem Festlegen der verbleibenden 22 Bits (0xFFFFFC00) des 32-Bit-Wertelements auf Nullen.

Value

Ein Element in der Union, das in D3DDDI_LOCKFLAGS enthalten ist, das einen 32-Bit-Wert enthalten kann, der das Sperren einer Ressource angibt.

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)

Weitere Informationen

D3DDDIARG_LOCK