D3DDDICB_LOCK Struktur (d3dumddi.h)
Die D3DDDICB_LOCK-Struktur beschreibt Parameter zum Sperren einer Zuordnung.
Syntax
typedef struct _D3DDDICB_LOCK {
[in/out] D3DKMT_HANDLE hAllocation;
[in] UINT PrivateDriverData;
[in] UINT NumPages;
[in] const UINT *pPages;
[out] VOID *pData;
[in] D3DDDICB_LOCKFLAGS Flags;
D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDICB_LOCK;
Member
[in/out] hAllocation
Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für die Zuordnung darstellt. Die PfnAllocateCb-Funktion der Microsoft Direct3D-Runtime gibt dieses Handle zurück. Daher sollte der Benutzermodusanzeigetreiber dieses Handle verwenden, um die Zuordnung zu sperren.
Wenn das Flag "Bitfeld verwerfen" im Flags-Element festgelegt ist, erstellt der Videospeicher-Manager eine neue instance der Zuordnung und gibt ein neues Handle zurück, das die neue instance darstellt.
[in] PrivateDriverData
Private Daten (z. B. MIP-Ebene), die vom Benutzermodusanzeigetreiber an die DxgkDdiAcquireSwizzlingRange-Funktion des Anzeigeminiporttreibers gesendet werden.
[in] NumPages
Die Anzahl der Seiten in der Seitenliste, auf die von pPages verwiesen wird.
[in] pPages
Ein Array von zu sperrenden Seiten. Jede Seite im Array wird durch einen ganzzahligen Offset beschrieben. Null bedeutet die erste Seite auf der Oberfläche, eine bedeutet die zweite usw.
[out] pData
Ein Zeiger auf den Speicher, der vom Anzeigeminiporttreiber und Speicher-Manager zurückgegeben wird. Beim Sperren einer Speicherseitenliste ist der zurückgegebene Zeiger ein Zeiger auf die erste Speicherseite.
[in] Flags
Eine D3DDDICB_LOCKFLAGS-Struktur , die in Bitfeldflags angibt, wie die Zuordnung gesperrt werden kann.
Beachten Sie, dass das gemeinsame Angeben einiger Flags ungültig ist und dass einige Flags von anderen Flags abhängen. Weitere Informationen zum Angeben dieser Flags finden Sie im Abschnitt Hinweise von D3DDDICB_LOCKFLAGS.
GpuVirtualAddress
Dieser Member ist reserviert und sollte auf null festgelegt werden.
Dieses Mitglied ist ab Windows 7 verfügbar.
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) |