PFND3DDDI_RENAME fungsi panggilan balik (d3dumddi.h)
Fungsi Ganti Nama menginformasikan driver tampilan mode pengguna untuk mulai menggunakan alokasi yang diganti namanya yang sebelumnya dikembalikan fungsi LockAsync untuk sumber daya yang ditentukan.
Sintaks
PFND3DDDI_RENAME Pfnd3dddiRename;
HRESULT Pfnd3dddiRename(
HANDLE hDevice,
const D3DDDIARG_RENAME *unnamedParam2
)
{...}
Parameter
hDevice
Handel ke perangkat tampilan (yaitu, konteks grafis).
unnamedParam2
pData [in]
Penunjuk ke struktur D3DDDIARG_RENAME yang menjelaskan sumber daya atau permukaan dalam sumber daya untuk mengganti nama dengan alokasi baru.
Menampilkan nilai
Mengganti nama mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| S_OK | Sumber daya berhasil diganti namanya. |
| E_OUTOFMEMORY | Ganti nama tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya. |
Keterangan
Pada komputer multi-prosesor, runtime Microsoft Direct3D memanggil fungsi Ganti Nama driver tampilan mode pengguna dari utas pekerja alih-alih dari utas aplikasi utama. Runtime memanggil Ganti Nama, paling banyak, sekali untuk setiap panggilan yang berhasil ke fungsi LockAsync driver dengan bendera Buang bit-field yang diatur dalam anggota Benderadari struktur D3DDDIARG_LOCKASYNC yang dituju oleh parameter pDataLockAsync .
Ganti nama memberi tahu driver untuk mulai menggunakan alokasi yang diganti namanya yang ditentukan oleh anggota hCookie dari struktur D3DDDIARG_RENAME yang ditujukan parameter pData dari Ganti Nama . Handel hCookie sebelumnya dikembalikan oleh fungsi LockAsync jika bendera Buang bit-field diatur untuk sumber daya terkunci.
Setelah Rename berhasil ditampilkan (dengan S_OK), driver tampilan mode pengguna harus menggunakan alokasi yang ditentukan hCookie untuk semua operasi penyajian yang mereferensikan sumber daya yang ditentukan oleh anggota hResource dan SubResourceIndex dari D3DDDIARG_RENAME.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
| Target Platform | Universal |
| Header | d3dumddi.h (termasuk D3dumddi.h) |