D3DKMT_LOCK Struktur (d3dkmthk.h)

Artikel
10/23/2024

Die D3DKMT_LOCK-Struktur beschreibt Parameter zum Sperren einer Zuordnung.

Syntax

typedef struct _D3DKMT_LOCK {
  [in]  D3DKMT_HANDLE          hDevice;
  [in]  D3DKMT_HANDLE          hAllocation;
  [in]  UINT                   PrivateDriverData;
  [in]  UINT                   NumPages;
  [in]  const UINT             *pPages;
  [out] VOID                   *pData;
  [in]  D3DDDICB_LOCKFLAGS     Flags;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DKMT_LOCK;

Angehörige

[in] hDevice

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für das Gerät darstellt, dem die Zuordnung zugeordnet ist.

[in] hAllocation

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für die zu sperrende Zuordnung darstellt.

[in] PrivateDriverData

Ein UINT-Wert, der 32 Bits privater Daten angibt (z. B. MIP-Ebene), die vom OpenGL ICD an die DxgkDdiAcquireSwizzlingRange Funktion des Anzeigeminiporttreibers gesendet wird.

[in] NumPages

Die Anzahl der Seiten in der Seitenliste, die pPages- angibt.

[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 zu diesen Kombinationen 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.