D3DDDIARG_LOCKASYNC-Struktur (d3dumddi.h)
Die D3DDDIARG_LOCKASYNC-Struktur beschreibt eine Ressource oder eine Oberfläche innerhalb der zu sperrenden Ressource.
Syntax
typedef struct _D3DDDIARG_LOCKASYNC {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
[in] D3DDDI_LOCKASYNCFLAGS Flags;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] HANDLE hCookie;
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;
Member
[in] hResource
Ein Handle für die zu sperrende Ressource.
[in] SubResourceIndex
Der nullbasierte Index in der Ressource, die hResource angibt. Dieser Index gibt die zu sperrende Unterressource oder Oberfläche an.
[in] Flags
Eine D3DDDI_LOCKASYNCFLAGS-Struktur , die in Bitfeldflags angibt, wie die Ressource gesperrt wird.
[in] Range
Eine D3DDDIRANGE-Struktur, die den Unterbereich der zu sperrenden linearen Ressource beschreibt, wenn das RangeValid-Bitfeldflag in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.
[in] Area
Eine RECT-Struktur , die das Subrectangle der zu sperrenden Oberfläche beschreibt, wenn das AreaValid-Bitfeldflag in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.
[in] Box
Eine D3DDDIBOX-Struktur, die das Untervolum des zu sperrenden Volumes beschreibt, wenn das BoxValid-Bitfeldflag in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.
[out] hCookie
Ein Handle, das die umbenannte Ressource darstellt. Dieses Handle ist nur gültig, wenn das Flag Bitfeld verwerfen in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.
[out] pSurfData
Ein Zeiger auf den Speicherbereich für die gesperrte Ressource. Die LockAsync-Funktion des Benutzermodusanzeigetreibers gibt diesen Zeiger auf die Microsoft Direct3D-Runtime zurück.
[out] Pitch
Die Tonhöhe der gesperrten Oberfläche in Bytes. Die LockAsync-Funktion des Benutzermodusanzeigetreibers gibt diesen Pitchwert an die Direct3D-Runtime zurück.
[out] SlicePitch
Der Slice-Pitch in Bytes der gesperrten Oberfläche. Die LockAsync-Funktion des Benutzermodusanzeigetreibers gibt diesen Slice pitch-Wert an die Direct3D-Runtime zurück.
GpuVirtualAddress
Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.
Dieses Mitglied ist ab Windows 7 verfügbar.
Hinweise
Die Member der D3DDDI_LOCKASYNCFLAGS-Struktur , die der Flags-Member angibt, müssen den folgenden Regeln entsprechen:
- Das NoOverwrite-Bitfeldflag darf nicht gleichzeitig mit dem Flag Bitfeld verwerfen festgelegt werden.
- Es muss jederzeit nur eines der Bitfeldflags RangeValid, AreaValid und BoxValid 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) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für