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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |