DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 fungsi panggilan balik (d3dkmddi.h)
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 dipanggil untuk mengubah konfigurasi overlay yang ditampilkan.
Sintaks
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;
NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
IN_CONST_HANDLE hAdapter,
IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}
Parameter
hAdapter
Mengidentifikasi adaptor yang berisi perangkat keras overlay.
pSetVidPnSourceAddressWithMultiPlaneOverlay
Penunjuk ke struktur DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 yang menjelaskan permukaan dan opsi tampilan untuk disajikan.
Nilai kembali
DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 mengembalikan nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | Rutinitas berhasil diselesaikan. |
| STATUS_INVALID_PARAMETER | Dalam [model antrean balik perangkat keras]/windows-hardware/drivers/display/hardware-flip-queue), driver tidak dapat memproses permintaan balik. |
| STATUS_RETRY | Dikembalikan karena alasan seperti driver gagal mengantre permintaan ke perangkat keras karena flip yang tertunda atau driver perlu dipanggil di PASSIVE_LEVEL. Jika driver perlu dipanggil pada PASSIVE_LEVEL itu juga harus mengatur DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Bendera PrePresentNeeded . |
Keterangan
Fungsi ini biasanya dipanggil pada tingkat interupsi, tetapi jika driver perlu melakukan konfigurasi perangkat keras yang hanya dapat dilakukan pada PASSIVE_LEVEL, driver dapat meminta agar fungsi ini ditarik kembali pada PASSIVE_LEVEL dengan mengembalikan STATUS_RETRY dan mengatur DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Bendera PrePresentNeeded .
Bahkan ketika dipanggil pada PASSIVE_LEVEL, driver harus menghindari menghabiskan sejumlah besar waktu dalam panggilan ini karena panggilan memblokir utas penjadwal GPU utama dan penundaan dapat menyebabkan gangguan. Tindakan intensif waktu harus diantrekan sebagai item kerja terpisah oleh driver dan ditangani di latar belakang. Dalam skenario ini, setiap konflik antara item yang diantrekan dan perubahan perangkat keras yang diminta oleh panggilan pra/pasca di masa mendatang harus dikelola oleh driver.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3dkmddi.h |