D3DDDI_LOCKASYNCFLAGS-Struktur (d3dumddi.h)

Die D3DDDI_LOCKASYNCFLAGS-Struktur gibt an, 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;

Member

NoOverwrite

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

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Elements Wert (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, müssen die Inhalte nicht vorab verarbeitet werden.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Wertmembers (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-Elements Wert (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-Wertmembers (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-Elements Wert (0x00000010).

NoExistingReferences

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

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

NotifyOnly

Ein UINT-Wert, der angibt, ob der Sperraufruf nur für Benachrichtigungen vorgesehen ist. Die Direct3D-Runtime legt NotifyOnly auf TRUE fest, wenn durch die Laufzeit zugewiesene Systemspeicheroberflächen gesperrt werden. In diesem Fall ignoriert die Runtime 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-Elements Wert (0x00000040).

Reserved

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

Value

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

Anforderungen

Weitere Informationen

D3DDDIARG_LOCKASYNC