struktur D3DDDICB_LOCK (d3dumddi.h)

  • Artikel

Struktur D3DDDICB_LOCK menjelaskan parameter untuk mengunci alokasi.

Sintaks

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;

Anggota

[in/out] hAllocation

Jenis data D3DKMT_HANDLE yang mewakili handel mode kernel ke alokasi. Fungsi pfnAllocateCb runtime Microsoft Direct3D mengembalikan handel ini. Oleh karena itu, driver tampilan mode pengguna harus menggunakan handel ini untuk mengunci alokasi.

Jika bendera Buang bit-field diatur di anggota Bendera , manajer memori video membuat instans baru alokasi dan mengembalikan handel baru yang mewakili instans baru.

[in] PrivateDriverData

Data privat (misalnya, tingkat MIP) yang dikirim dari driver tampilan mode pengguna ke fungsi DxgkDdiAcquireSwizzlingRange driver miniport tampilan.

[in] NumPages

Jumlah halaman dalam daftar halaman yang ditujukan oleh pPages.

[in] pPages

Array halaman yang akan dikunci. Setiap halaman dalam array dijelaskan oleh offset bilangan bulat. Nol berarti halaman pertama di permukaan, satu berarti yang kedua, dan sebagainya.

[out] pData

Penunjuk ke memori yang dikembalikan dari driver miniport tampilan dan manajer memori. Saat mengunci daftar halaman memori, penunjuk yang dikembalikan adalah penunjuk ke halaman memori pertama.

[in] Flags

Struktur D3DDDICB_LOCKFLAGS yang mengidentifikasi, dalam bendera bit-field, cara mengunci alokasi.

Perhatikan bahwa menentukan beberapa bendera bersama-sama tidak valid dan bahwa beberapa bendera bergantung pada bendera lain. Untuk informasi selengkapnya tentang menentukan bendera ini, lihat bagian Keterangan di D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

Anggota ini dicadangkan dan harus diatur ke nol.

Anggota ini tersedia dimulai dengan Windows 7.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb