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) |