Fungsi DrvAssertMode (winddi.h)

Fungsi DrvAssertMode mengatur mode perangkat fisik yang ditentukan ke mode yang ditentukan ketika PDEV diinisialisasi atau ke mode default perangkat keras.

Sintaks

BOOL DrvAssertMode(
  [in] DHPDEV dhpdev,
  [in] BOOL   bEnable
);

Parameter

[in] dhpdev

Tangani ke PDEV yang menjelaskan mode perangkat keras yang harus diatur ketika bEnableTRUE.

[in] bEnable

Menentukan mode di mana perangkat keras akan disetel. Jika parameter ini TRUE, driver harus mengatur perangkat keras ke mode asli yang ditentukan oleh PDEV yang diinisialisasi. Jika tidak, jika parameter ini FALSE, driver harus mengatur perangkat keras ke mode defaultnya sehingga driver miniport video dapat mengasumsikan kontrol.

Nilai kembali

DrvAssertMode mengembalikan TRUE jika berhasil mengubah mode tampilan; mengembalikan FALSE jika tidak dapat mengubah mode tampilan. Driver diizinkan untuk mengembalikan FALSE dari panggilan DrvAssertMode dengan bEnable diatur ke FALSE. Driver harus mengembalikan TRUE dari panggilan DrvAssertMode dengan bEnable diatur ke TRUE; artinya, driver tidak dapat gagal mengaktifkan mode yang sebelumnya diaktifkan.

Keterangan

GDI memanggil DrvAssertMode ketika diperlukan untuk beralih di antara beberapa desktop pada satu permukaan tampilan. Untuk beralih dari satu PDEV ke PDEV lainnya, GDI memanggil DrvAssertMode dengan parameter bEnable yang diatur ke FALSE untuk satu PDEV, dan TRUE untuk yang lain. Untuk kembali ke PDEV asli, DrvAssertMode dipanggil dengan bEnable diatur ke FALSE, diikuti dengan panggilan lain ke DrvAssertMode, dengan bEnable diatur ke TRUE dan dhpdev diatur ke PDEV asli.

Jika perangkat fisik dikelola palet, GDI akan memanggil DrvSetPalette untuk mengatur ulang palet perangkat. Driver kemudian tidak perlu melacak status penunjuk saat ini karena Window Manager memilih bentuk penunjuk yang benar dan memindahkannya ke posisi saat ini. Manajer konsol memastikan bahwa desktop digambar ulang dengan benar.

DrvAssertMode harus diimplementasikan dalam driver tampilan.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	winddi.h (termasuk Winddi.h)

Lihat juga

DrvGetModes

DrvSetPalette