D3DDDI_LOCKFLAGS Struktur (d3dumddi.h)
Die D3DDDI_LOCKFLAGS Struktur identifiziert, 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;
Angehörige
ReadOnly
Ein UINT-Wert, der angibt, ob die gesperrte Ressource nur gelesen werden kann. Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Value Members (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-Value Members (0x00000002).
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 Direct3D-Vertexpuffersperren verwendet.
Das Festlegen dieses Elements entspricht dem Festlegen des dritten Bits des 32-Bit-Value Members (0x00000004).
Discard
Ein UINT-Wert, der angibt, ob die gesamte gesperrte Ressource geändert wird. Da der vorhandene Inhalt daher verworfen werden kann, ist keine vorläufige Verarbeitung erforderlich.
Das Festlegen dieses Elements entspricht dem Festlegen des vierten Bits des 32-Bit-Value Members (0x00000008).
RangeValid
Ein UINT-Wert, der angibt, ob die gesperrte Ressource linear ist.
Das Festlegen dieses Elements entspricht dem Festlegen des fünften Bits des 32-Bit-Value Members (0x00000010).
AreaValid
Ein UINT-Wert, der angibt, ob die gesperrte Ressource eine Oberfläche ist.
Das Festlegen dieses Elements entspricht dem Festlegen des sechsten Bits des 32-Bit-Value Members (0x00000020).
BoxValid
Ein UINT-Wert, der angibt, ob die gesperrte Ressource ein Volume ist.
Das Festlegen dieses Elements entspricht dem Festlegen des siebten Bits des 32-Bit-Value Members (0x00000040).
NotifyOnly
Ein UINT-Wert, der angibt, ob der Sperraufruf nur für Benachrichtigungen vorgesehen ist.
Das Festlegen dieses Elements entspricht dem Festlegen des achten Bits des 32-Bit-Value Members (0x00000080).
MightDrawFromLocked
Ein UINT-Wert, der angibt, ob der Treiber möglicherweise zum Zeichnen aus einem Vertexpuffer angefordert wird, auch wenn der Vertexpuffer von der Direct3D-Laufzeit gesperrt ist. MightDrawFromLocked garantiert nicht, dass der Treiber Aufrufe an seine DrawIndexedPrimitive, DrawIndexedPrimitive2, DrawPrimitiveund DrawPrimitive2 Funktionen nach dem Aufruf von Lockempfängt. MightDrawFromLocked- wird nur für Vertexpuffer festgelegt, die mit dem MightDrawFromLocked Bitfeldflagge erstellt wurden, das im Flags Member der D3DDDIARG_CREATERESOURCE Struktur während der Erstellungszeit festgelegt wurde.
Das Festlegen dieses Elements entspricht dem Festlegen des neunten Bits des 32-Bit-Value Members (0x00000100).
DoNotWait
Ein UINT-Wert, der angibt, ob der Anzeigetreiber für den Benutzermodus warten soll, bis die Ressource im Leerlauf ist. Das Festlegen DoNotWait- gibt an, dass der Anzeigetreiber für den Benutzermodus nicht warten sollte, bis die Ressource im Leerlauf ist.
Das Festlegen dieses Elements entspricht dem Festlegen des zehnten Bits des 32-Bit-Value Members (0x00000200).
Reserved
Dieses Element ist reserviert und sollte auf Null festgelegt werden. Das Festlegen dieses Elements auf Null entspricht dem Festlegen der verbleibenden 22 Bits (0xFFFFFC00) des 32-Bit-Werts Members auf Nullen.
Value
Ein Mitglied in der Union, das in D3DDDI_LOCKFLAGS 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) |