DXGKDDI_EXCHANGEPRESTARTINFO fungsi panggilan balik (dispmprt.h)

Artikel
02/23/2024

Memungkinkan data yang sangat sederhana untuk ditukar antara OS dan driver yang mungkin diperlukan sebelum perangkat DxgkDdiStartDevice dipanggil dan oleh karena itu tidak dapat dikueri melalui batas normal atau DDI info adaptor.

Sintaks

DXGKDDI_EXCHANGEPRESTARTINFO DxgkddiExchangeprestartinfo;

NTSTATUS DxgkddiExchangeprestartinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_OUT_PDXGK_PRE_START_INFO pPreStartInfo
)
{...}

Parameter

[in] hAdapter

Mengidentifikasi adaptor.

[in] pPreStartInfo

Penunjuk ke struktur DXGK_PRE_START_INFO , yang berisi kedua bidang agar OS meneruskan info dan bidang agar driver mengembalikan info. Awalnya, hanya SupportPreserveBootDisplay yang ditentukan.

[out] SupportPreserveBootDisplay

Driver dan perangkat keras mendukung persyaratan yang memungkinkan buffer bingkai boot digunakan dan ditampilkan di seluruh inisialisasi perangkat keras, yang dilakukan selama DxgkDdiStartDevice.

Nilai kembali

Jika rutinitas ini berhasil dan mengembalikan perubahan yang diminta, rutinitas akan mengembalikan STATUS_SUCCESS.

Keterangan

DDI ini akan dipanggil setelah DxgkDdiAddDevice dan sebelum DxgkDdiStartDevice sehingga driver tidak memiliki akses ke sumber daya perangkat kerasnya sendiri. Namun, dapat menggunakan PhysicalDeviceObject yang diteruskan ke driver di DxgkDdiAddDevice untuk memanggil IoGetDeviceProperty. Misalnya, dapat menemukan id perangkat keras untuk memutuskan apa yang harus dikembalikan dalam bidang output struktur DXGK_PRE_START_INFO.

Fungsi ini selalu dipanggil pada tingkat PASIF sehingga kode pendukung harus dibuat dapat di-pageable jika memungkinkan.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dispmprt.h

Bagikan melalui