DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP fungsi panggilan balik (dispmprt.h)

Artikel
08/07/2023

Dipanggil oleh Driver Model Tampilan Windows (WDDM) 1.2 atau yang lebih baru menampilkan driver miniport untuk mendapatkan informasi tampilan dari perangkat tampilan uji mandiri (POST) daya saat ini atau driver WDDM yang sebelumnya berjalan.

Pengandar harus menggunakan informasi tampilan ini untuk mengoptimalkan permintaan perubahan mode awal setelah perangkat tampilan dimulai.

Sintaks

DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP DxgkcbAcquirePostDisplayOwnership;

NTSTATUS DxgkcbAcquirePostDisplayOwnership(
  [in]  HANDLE DeviceHandle,
  [out] PDXGK_DISPLAY_INFORMATION DisplayInfo
)
{...}

Parameter

[in] DeviceHandle

Handel yang mewakili adaptor tampilan. Driver miniport tampilan sebelumnya memperoleh handel ini di anggota DeviceHandle dari struktur DXGKRNL_INTERFACE yang diteruskan ke DxgkDdiStartDevice.

[out] DisplayInfo

Penunjuk ke struktur DXGK_DISPLAY_INFORMATION yang dialokasikan oleh driver miniport tampilan. Jika DxgkCbAcquirePostDisplayOwnership mengembalikan STATUS_SUCCESS, struktur ini berisi informasi tampilan untuk perangkat tampilan saat ini yang digunakan untuk operasi POST.

Nilai kembali

DxgkCbAcquirePostDisplayOwnership mengembalikan STATUS_SUCCESS jika berhasil. Jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Format warna yang diizinkan

Anggota DisplayInfo->ColorFormat harus menyertakan kombinasi bitwise-OR dari dua format berikut:

D3DDDIFMT_X8R8G8B8
D3DDDIFMT_A8R8G8B8

Jika sistem operasi melaporkan kembali format D3DDDIFMT_R8G8B8 , driver miniport tampilan harus mengabaikannya.

Video menyajikan inisialisasi target

Ada kemungkinan bahwa anggota DisplayInfo->TargetId tidak diinisialisasi. Dalam hal ini, pengidentifikasi target video yang ada D3DDDI_ID_UNINITIALIZED. Biasanya, ini terjadi setelah boot sistem.

Demikian pula, ada kemungkinan bahwa anggota DisplayInfo-AcpiId> tidak diinisialisasi. Dalam hal ini, AcpiId pengidentifikasi ACPI memiliki nilai nol.

Dalam kasus peningkatan driver-ke-driver, driver sebelumnya akan memberikan pengidentifikasi target dan pengidentifikasi ACPI.

Pedoman implementasi

Dimulai dengan WDDM 1.2, driver miniport tampilan harus mengikuti panduan ini ketika memanggil DxgkCbAcquirePostDisplayOwnership:

Titik masuk untuk fungsi DxgkCbAcquirePostDisplayOwnership adalah bagian dari struktur DXGKRNL_INTERFACE . Struktur ini dikembalikan ke driver melalui parameter DxgkInterface ketika fungsi DxgkDdiStartDevice driver dipanggil.
Ini opsional bagi driver miniport tampilan untuk memanggil DxgkCbAcquirePostDisplayOwnership. Namun, sistem operasi mungkin masih memanggil fungsi DxgkDdiStopDeviceAndReleasePostDisplayOwnership driver perangkat jika driver sebelumnya tidak memanggil DxgkCbAcquirePostDisplayOwnership.
Driver miniport tampilan dapat memanggil DxgkCbAcquirePostDisplayOwnership jika perangkat dimulai sebagai respons terhadap peristiwa Plug and Play (PnP). Dalam hal ini, driver harus memanggil DxgkCbAcquirePostDisplayOwnership dari dalam konteks panggilan ke fungsi DxgkDdiStartDevice .
Driver miniport tampilan dapat memanggil DxgkCbAcquirePostDisplayOwnership jika perangkat melanjutkan status daya PowerDeviceD0 setelah status hibernasi. Dalam hal ini, driver harus memanggil DxgkCbAcquirePostDisplayOwnership dari dalam konteks panggilan ke fungsi DxgkDdiSetPowerState .
Driver miniport tampilan hanya boleh memanggil fungsi DxgkCbAcquirePostDisplayOwnership jika driver berjalan di bawah Windows 8 atau versi sistem operasi Windows yang lebih baru.
Catatan Driver miniport tampilan dapat memanggil RtlGetVersion untuk menentukan versi sistem operasi.
DxgkCbAcquirePostDisplayOwnership dapat mengembalikan struktur DXGK_DISPLAY_INFORMATION dengan anggota Lebar diatur ke nol. Ini menunjukkan bahwa perangkat tampilan saat ini tidak mampu melakukan operasi POST atau sistem operasi tidak memiliki informasi tampilan saat ini untuk perangkat POST saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Desktop
Header	dispmprt.h (termasuk Dispmprt.h)
IRQL	<= APC_LEVEL