D3DDDIARG_LOCK Struktur (d3dumddi.h)
Die D3DDDIARG_LOCK-Struktur beschreibt eine Ressource oder eine Oberfläche innerhalb der zu sperrenden Ressource.
Syntax
typedef struct _D3DDDIARG_LOCK {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
[in] D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;
Member
[in] hResource
Ein Handle für die zu sperrende Ressource.
[in] SubResourceIndex
Der nullbasierte Index in die Ressource, der durch das von hResource angegebene Handle angegeben wird. Dieser Index gibt die zu sperrende Unterressource oder Oberfläche an.
[in] Range
Eine D3DDDIRANGE Struktur, die den Unterbereich der zu sperrenden linearen Ressource beschreibt.
[in] Area
Eine RECT-Struktur , die das Unterrectangle der zu sperrenden Oberfläche beschreibt.
[in] Box
Eine D3DDDIBOX-Struktur, die das Teilvolum des zu sperrenden Volumes beschreibt.
[out] pSurfData
Ein Zeiger auf den Speicherbereich für die ressource, die gesperrt war. Die Sperrfunktion des Benutzermodusanzeigetreibers gibt diesen Zeiger auf die Microsoft Direct3D-Runtime zurück.
[out] Pitch
Die Tonhöhe der gesperrten Oberfläche in Bytes. Die Lock-Funktion des Benutzermodusanzeigetreibers gibt diesen Pitchwert an die Direct3D-Runtime zurück.
[out] SlicePitch
Der Slice-Pitch (in Bytes) der gesperrten Oberfläche. Die Lock-Funktion des Benutzermodusanzeigetreibers gibt diesen Slice Pitch-Wert an die Direct3D-Runtime zurück.
[in] Flags
Eine D3DDDI_LOCKFLAGS-Struktur , die in Bitfeldflags angibt, wie die Ressource gesperrt werden soll. Beachten Sie, dass einige Flags sich gegenseitig mit anderen Flags ausschließen. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Hinweise
Die Elemente der Struktur, die vom Flags-Member angegeben werden, müssen die folgenden Regeln erfüllen:
- Die Bitfeldflags ReadOnly und WriteOnly dürfen nicht gleichzeitig festgelegt werden.
- Das NoOverwrite-Bitfeldflag darf nicht gleichzeitig mit dem Flag "Bitfeld verwerfen" festgelegt werden.
- Nur eines der RangeValid-, AreaValid- und BoxValid-Bitfeldflags muss jederzeit festgelegt werden.
- Das ReadOnly-Bitfeldflag darf nicht gleichzeitig mit dem Flag "Bitfeld verwerfen" festgelegt werden.
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) |