Freigeben über


D3DDDI_LOCKASYNCFLAGS Struktur (d3dumddi.h)

Die D3DDDI_LOCKASYNCFLAGS Struktur identifiziert, wie eine Ressource gesperrt wird.

Syntax

typedef struct _D3DDDI_LOCKASYNCFLAGS {
  union {
    struct {
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT RangeValid : 1;
      UINT AreaValid : 1;
      UINT BoxValid : 1;
      UINT NoExistingReferences : 1;
      UINT NotifyOnly : 1;
      UINT Reserved : 25;
    };
    UINT Value;
  };
} D3DDDI_LOCKASYNCFLAGS;

Angehörige

NoOverwrite

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

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

Discard

Ein UINT-Wert, der angibt, ob die gesamte gesperrte Ressource geändert wird. Wenn dieser Wert festgelegt ist, da der vorhandene Inhalt verworfen werden kann, ist für den Inhalt keine vorläufige Verarbeitung erforderlich.

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

RangeValid

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

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

AreaValid

Ein UINT-Wert, der angibt, ob die gesperrte Ressource eine Oberfläche ist.

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

BoxValid

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

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

NoExistingReferences

Ein UINT-Wert, der angibt, ob die Microsoft Direct3D-Laufzeit verweise auf die zu sperrende Ressource in der Warteschlange enthält. Wenn NoExistingReferences- festgelegt ist, bestimmt der Treiber, dass keine intern in die Warteschlange stehenden Verweise auf die Ressource verfügbar sind. Der Treiber kann dann die NoExistingReferences Bitfeldkennzeichnung der D3DDDICB_LOCK Struktur festlegen, wenn der Treiber die pfnLockCb--Funktion aufruft, um einen Sperrverwerfen-Vorgang auszuführen.

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

NotifyOnly

Ein UINT-Wert, der angibt, ob der Sperraufruf nur für Benachrichtigungen vorgesehen ist. Die Direct3D-Laufzeit legt NotifyOnly auf "TRUE" fest, wenn sie vom Laufzeit zugewiesene Systemspeicheroberflächen sperrt. In diesem Fall ignoriert die Laufzeit den Zeiger, den der Treiber im pSurfData- Member der D3DDDIARG_LOCKASYNC Struktur zurückgibt.

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

Reserved

Dieses Element ist reserviert und sollte auf Null festgelegt werden. Das Festlegen dieses Elements auf Null entspricht dem Festlegen der verbleibenden 25 Bits (0xFFFFFF80) des 32-Bit-Werts Members auf Nullen.

Value

Ein Mitglied in der Union, das in D3DDDI_LOCKASYNCFLAGS enthalten ist, der einen 32-Bit-Wert enthalten kann, der angibt, wie eine Ressource gesperrt wird.

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)

Siehe auch

D3DDDIARG_LOCKASYNC