Freigeben über


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;

Angehörige

[in/out] hAllocation

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für die Zuordnung darstellt. Die pfnAllocateCb--Funktion der Microsoft Direct3D-Laufzeit gibt dieses Handle zurück. Daher sollte der Anzeigetreiber für den Benutzermodus dieses Handle verwenden, um die Zuordnung zu sperren.

Wenn das Verwerfen Bitfeldkennzeichnung im Flags Member festgelegt ist, erstellt der Videospeicher-Manager eine neue Instanz der Zuordnung und gibt ein neues Handle zurück, das die neue Instanz darstellt.

[in] PrivateDriverData

Private Daten (z. B. MIP-Ebene), die vom Anzeigetreiber für den Benutzermodus an die DxgkDdiAcquireSwizzlingRange Funktion des Anzeigetreibers gesendet werden.

[in] NumPages

Die Anzahl der Seiten in der Seitenliste, auf die von pPagesverwiesen wird.

[in] pPages

Ein Array von Seiten, die gesperrt werden sollen. 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 Display Miniporttreiber 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 die Zuordnung in Bitfeldkennzeichnungen identifiziert.

Beachten Sie, dass das Angeben einiger Flags ungültig ist und dass einige Flags von anderen Flags abhängen. Weitere Informationen zum Angeben dieser Kennzeichnungen finden Sie im Abschnitt "Hinweise" von D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

Dieses Element ist reserviert und sollte auf Null festgelegt werden.

Dieses Mitglied ist ab Windows 7 verfügbar.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header- d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb