DXGKDDI_OPENALLOCATIONINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi DxgkDdiOpenAllocation mengikat alokasi khusus non-perangkat yang dibuat oleh fungsi DxgkDdiCreateAllocation untuk alokasi yang khusus untuk perangkat konteks grafis yang ditentukan.

Sintaks

DXGKDDI_OPENALLOCATIONINFO DxgkddiOpenallocationinfo;

NTSTATUS DxgkddiOpenallocationinfo(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_OPENALLOCATION pOpenAllocation
)
{...}

Parameter

[in] hDevice

Handel ke perangkat konteks grafis tempat alokasi terikat. Fungsi DxgkDdiCreateDevice driver miniport tampilan sebelumnya memberikan handel ini ke subsistem kernel grafis Microsoft DirectX di anggota hDevice dari struktur DXGKARG_CREATEDEVICE .

[in] pOpenAllocation

Penunjuk ke struktur DXGKARG_OPENALLOCATION yang berisi informasi tentang alokasi pengikatan.

Menampilkan nilai

DxgkDdiOpenAllocation mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	DxgkDdiOpenAllocation berhasil mengikat alokasi ke perangkat konteks grafis yang ditentukan parameter hDevice.
STATUS_INVALID_PARAMETER	Parameter yang diteruskan ke DxgkDdiOpenAllocation berisi kesalahan yang mencegahnya selesai.
STATUS_NO_MEMORY	DxgkDdiOpenAllocation tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.
STATUS_GRAPHICS_DRIVER_MISMATCH	Driver miniport tampilan tidak kompatibel dengan driver tampilan mode pengguna yang memulai panggilan ke DxgkDdiOpenAllocation (yaitu, memasok data pribadi ke driver miniport tampilan).

Keterangan

Subsistem kernel grafis DirectX memanggil fungsi DxgkDdiOpenAllocation driver miniport tampilan untuk mengikat alokasi khusus nondevice yang ditentukan oleh fungsi DxgkDdiCreateAllocation yang dibuat untuk alokasi yang khusus untuk perangkat konteks grafis yang ditentukan parameter hDevice . Driver miniport tampilan mengikat alokasi ke perangkat sehingga driver dapat melacak data alokasi yang khusus untuk perangkat.

Driver miniport tampilan dapat mengikat alokasi ke perangkat apa pun yang dibuat oleh proses apa pun (pada adaptor grafis yang sama) dan bukan hanya ke perangkat dalam proses pembuatan.

Ketika DxgkDdiOpenAllocation mengembalikan STATUS_SUCCESS, driver menetapkan anggota hDeviceSpecificAllocation dari struktur DXGK_OPENALLOCATIONINFO untuk setiap alokasi ke nilai non-NULL. Struktur DXGK_OPENALLOCATIONINFO untuk setiap alokasi adalah elemen array yang ditentukan anggota pOpenAllocation dari struktur DXGKARG_OPENALLOCATION .

Driver dapat memodifikasi data driver privat alokasi yang diteruskan di anggota pPrivateDriverData dari struktur DXGK_OPENALLOCATIONINFO hanya ketika alokasi dibuat (yang ditunjukkan ketika bendera Buat bit-field di anggota Bendera dari struktur DXGKARG_OPENALLOCATION diatur). Driver harus menentukan bahwa driver hanya dapat membaca data driver pribadi alokasi ketika alokasi dibuka (yaitu, ketika bendera Buat bit-field tidak diatur).

DxgkDdiOpenAllocation harus dibuat pageable.