PFND3DDDI_UNLOCK fungsi panggilan balik (d3dumddi.h)
Fungsi Buka kunci membuka sumber daya atau permukaan dalam sumber daya yang sebelumnya dikunci oleh fungsi Kunci .
Sintaks
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
Parameter
hDevice
Handel ke perangkat tampilan (konteks grafis).
unnamedParam2
pData [in]
Penunjuk ke struktur D3DDDIARG_UNLOCK yang menjelaskan sumber daya atau permukaan dalam sumber daya untuk membuka kunci.
Menampilkan nilai
Buka kunci mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
S_OK | Sumber daya berhasil dibuka kuncinya. |
E_OUTOFMEMORY | Buka kunci tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya. |
E_INVALIDARG | Sumber daya yang D3DDDIARG_UNLOCK jelaskan tidak dikunci oleh panggilan sebelumnya ke fungsi Kunci driver. |
Keterangan
Komentar ini dianalogikan dengan deskripsi di bagian Keterangan dari halaman Referensi kunci .
Driver tampilan mode pengguna harus memanggil fungsi pfnUnlockCb runtime Microsoft Direct3D setelah Unlock dipanggil. Dalam panggilan pfnUnlockCb ini, driver tampilan mode pengguna melewati handel alokasi. Sebelum memanggil pfnUnlockCb, driver tampilan mode pengguna harus terlebih dahulu memetakan permukaan ke alokasi yang sesuai.
Runtime memanggil fungsi Buka Kunci driver tampilan mode pengguna untuk membuka kunci permukaan memori sistem yang telah dialokasikan sebelumnya juga. Runtime mengatur bendera bit-field NotifyOnly di anggota Bendera struktur D3DDDIARG_UNLOCK yang ditunjukkan oleh pData untuk membedakan panggilan Unlock yang membuka kunci memori sistem yang telah dialokasikan sebelumnya dari panggilan Buka kunci lainnya. Jika fungsi Penguncian driver tampilan mode pengguna yang disebut pfnLockCb untuk mengunci alokasi memori sistem yang sesuai dengan permukaan, itu juga harus memanggil pfnUnlockCb. Tidak memanggil pfnUnlockCb menghentikan koordinasi antara runtime, driver tampilan mode pengguna, dan driver miniport tampilan.
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) |