struktur D3DDDICB_QUERYRESIDENCY (d3dumddi.h)

Struktur D3DDDICB_QUERYRESIDENCY menjelaskan status residensi sumber daya atau daftar alokasi.

Sintaks

typedef struct _D3DDDICB_QUERYRESIDENCY {
  [in]  HANDLE                 hResource;
  [in]  UINT                   NumAllocations;
  [in]  const D3DKMT_HANDLE    *HandleList;
  [out] D3DDDI_RESIDENCYSTATUS *pResidencyStatus;
} D3DDDICB_QUERYRESIDENCY;

Anggota

[in] hResource

Handel ke sumber daya yang residensinya dikueri. Jika driver tampilan mode pengguna menggunakan array di anggota HandleList untuk mengkueri residensi, ia mengatur hResource ke NULL.

Jika hResource bukan NULL, semua alokasi yang termasuk dalam sumber daya dikueri, dan hasilnya dikembalikan dalam elemen pertama dari array yang dituju pResidencyStatus . Status residensi sumber daya sama dengan status residensi terendah dari semua alokasi yang termasuk dalam sumber daya.

[in] NumAllocations

Jumlah alokasi dalam array HandleList . Jika driver tampilan mode pengguna mengatur handel di anggota hResource ke non-NULL, itu harus mengatur NumAllocations ke nol.

[in] HandleList

Array D3DKMT_HANDLE jenis data yang mewakili handel mode kernel ke alokasi. Fungsi pfnAllocateCb runtime Microsoft Direct3D mengembalikan handel ini. Oleh karena itu, driver tampilan mode pengguna menggunakan handel ini untuk meminta residensi.

Jika driver tampilan mode pengguna mengatur handel di anggota hResource ke non-NULL, driver harus mengatur HandleList ke NULL.

[out] pResidencyStatus

Penunjuk ke array nilai D3DDDI_RESIDENCYSTATUS. Jika anggota hResource bukan NULL, array berisi satu elemen dan menerima salah satu nilai berikut untuk menunjukkan status residensi sumber daya. Jika hResource adalah NULL, jumlah elemen dalam array ditentukan oleh anggota NumAllocations , dan setiap elemen menerima salah satu nilai berikut untuk menunjukkan status residensi alokasi yang sesuai dalam array yang ditentukan oleh HandleList.

Nilai	Makna
D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY (1)	Sumber daya atau daftar alokasi berada di memori GPU, yang merupakan status residensi tertinggi.
D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY (2)	Sumber daya atau daftar alokasi berada di memori bersama.
D3DDDI_RESIDENCYSTATUS_NOTRESIDENT (3)	Sumber daya atau daftar alokasi tidak diketahui, yang merupakan status residensi terendah.

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

pfnQueryResidencyCb