D3DKMT_LOCK Struktur (d3dkmthk.h)

Artikel
10/07/2023

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;

Member

[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 werden.

[in] NumPages

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

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