PFND3DDDI_UNLOCKASYNC fungsi panggilan balik (d3dumddi.h)

Artikel
03/08/2023

Fungsi UnlockAsync membuka kunci sumber daya atau permukaan dalam sumber daya yang sebelumnya dikunci oleh fungsi LockAsync .

Sintaks

PFND3DDDI_UNLOCKASYNC Pfnd3dddiUnlockasync;

HRESULT Pfnd3dddiUnlockasync(
  HANDLE hDevice,
  const D3DDDIARG_UNLOCKASYNC *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (yaitu, konteks grafis).

unnamedParam2

pData [in]

Penunjuk ke struktur D3DDDIARG_UNLOCKASYNC yang menjelaskan sumber daya atau permukaan dalam sumber daya untuk membuka kunci.

Menampilkan nilai

UnlockAsync mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	Sumber daya berhasil dibuka kuncinya.
E_OUTOFMEMORY	UnlockAsync tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.
E_INVALIDARG	Sumber daya yang D3DDDIARG_UNLOCKASYNC jelaskan tidak dikunci oleh panggilan sebelumnya ke fungsi LockAsync driver.

Keterangan

Driver tampilan mode pengguna harus memanggil fungsi pfnUnlockCb dengan handel alokasi yang sesuai setelah fungsi UnlockAsync dipanggil.

Driver tampilan mode pengguna secara opsional mengimplementasikan UnlockAsync; runtime Microsoft Direct3D memanggil UnlockAsync hanya jika driver mengimplementasikan fungsi LockAsync, UnlockAsync, dan Rename .

Seperti LockAsync, UnlockAsync dipanggil pada utas aplikasi utama sementara sebagian besar panggilan lain ke fungsi driver tampilan mode pengguna dilakukan pada utas pekerja (pada komputer multi-prosesor).

Jika driver tampilan mode pengguna mengekspos versi DDI 0x0000000B atau lebih besar (driver mengembalikan nilai ini di anggota DriverVersion dari struktur D3D10DDIARG_OPENADAPTER dalam panggilan ke fungsi OpenAdapter driver), runtime Direct3D akan memanggil UnlockAsync dengan cara yang masuk kembali. Ketika runtime memanggil UnlockAsync dengan cara yang masuk kembali, satu utas dapat dijalankan di dalam UnlockAsync sementara utas lain yang mereferensikan perangkat tampilan yang sama dijalankan di dalam fungsi driver tampilan mode pengguna lain.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDIARG_UNLOCKASYNC