PFND3DDDI_UNLOCK fungsi panggilan balik (d3dumddi.h)

Artikel
03/08/2023

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)

Lihat juga