IOCTL_MIPI_DSI_RESET IOCTL (ntddvdeo.h)

Artikel
08/07/2023

IOCTL_MIPI_DSI_RESET meminta reset perangkat di bawah driver grafis dan kontrol OS.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

n/a

Panjang buffer input

n/a

Buffer output

n/a

Panjang buffer output

n/a

Buffer Input/Output

Struktur DXGK_DSI_RESET .

Panjang buffer Input/Output

Setidaknya sizeof(DXGK_DSI_RESET)

Blok status

Irp-IoStatus.Status> diatur ke STATUS_SUCCESS jika permintaan berhasil. Jika tidak, Status ke kondisi kesalahan yang sesuai sebagai kode NTSTATUS.

Untuk informasi selengkapnya, lihat Nilai NTSTATUS.

Keterangan

IOPL Antarmuka Serial Digital (DSI) Mobile Industry Processor Interface (MIPI) harus ditangani oleh driver monitor, oem-panel, atau port/miniport.

Jika driver panel OEM mendeteksi bahwa panel dalam keadaan buruk, panel harus mengirim IOCTL_MIPI_DSI_RESET untuk meminta reset perangkat di bawah driver grafis dan kontrol OS. OS akan mengoordinasikan reset dengan driver grafis. Reset adalah operasi berat yang akan menyebabkan pengosongan tampilan untuk beberapa bingkai, dan karenanya harus digunakan hanya sebagai upaya terakhir.

Operasi panel normal tidak dapat dilanjutkan saat memproses reset, sehingga OS akan memperlakukan mirip dengan perubahan mode tampilan, membersihkan aktivitas GPU yang tertunda, termasuk flip apa pun, dan memblokir pekerjaan baru hingga selesai. OS menerjemahkan IOCTL ke dalam panggilan DsiReset DDI. Driver harus sepenuhnya menghilangkan daya dari panel dan menginisialisasinya kembali dari awal, dan setelah penundaan yang sesuai, lakukan tindakan apa pun yang diperlukan untuk memulihkan panel ke keadaan yang dapat dikerjakan sebelum kembali. Ketika diatur, bendera SecondaryPort menunjukkan bahwa reset harus ditargetkan ke panel sekunder daripada yang utama.

Jika driver grafis memerlukan mode penuh yang diatur untuk melakukan atau memulihkan dari reset panel, driver harus mengatur bendera output NeedModeSet. Jika diatur saat kembali dari panggilan, OS akan merespons dengan panggilan DxgkDdiSetTimingsFromVidPn sebelum membuka blokir aktivitas normal. Driver dapat memilih untuk menunda beberapa pekerjaan reset ke panggilan ini jika diperlukan, asalkan status yang dapat dikerjakan diharapkan mengikuti panggilan pengaturan waktu.

Driver grafis harus melaporkan kesalahan MIPI tingkat rendah yang terdeteksi dan tidak ditangani oleh driver melalui bidang output MipiErrors .

Jika terjadi kesalahan yang tidak dapat dipulihkan selama reset, driver grafis harus mengatur bendera output ResetFailed . Hal ini diperkirakan akan menjadi kegagalan besar. Driver grafis juga harus memberi sinyal bahwa tidak ada tampilan yang tersedia pada target dengan menunjukkan bahwa cabut telah terjadi menggunakan panggilan balik DxgkCbIndicateConnectorChange dan kemudian merespons DxgkDdiQueryConnectionChange dengan melaporkan TargetStatusDisconnected untuk target yang gagal.

Bidang output akan disebarluaskan kembali ke buffer output IOCTL.