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) |