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)

Weitere Informationen

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb