Fungsi DrvGetModes (winddi.h)

Artikel
03/04/2024

Fungsi DrvGetModes mencantumkan mode yang didukung oleh perangkat tertentu.

Sintaks

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

Parameter

[in] hDriver

Tangani ke driver yang modenya harus dijumlahkan. Ini adalah handel yang diteruskan dalam parameter hDriver dari fungsi DrvEnablePDEV .

cjSize

Menentukan ukuran dalam byte buffer yang diacu oleh pdm.

[out, optional] pdm

Arahkan ke buffer yang berisi struktur DEVMODEW agar driver dapat mengisi, atau NULL.

Nilai kembali

Driver harus mengembalikan jumlah byte yang ditulis ke buffer jika pdm bukan NULL. Jika pdm adalah NULL, driver harus mengembalikan jumlah byte yang diperlukan untuk menyimpan semua data mode. Driver harus mengembalikan nol jika terjadi kesalahan.

Keterangan

Fungsi ini harus diimplementasikan di semua driver tampilan.

Window Manager secara dinamis memuat semua driver tampilan yang terkait dengan driver miniport (berdasarkan kunci InstalledDisplayDrivers di registri ). Setiap driver tampilan dipanggil untuk mengambil daftar mode yang didukung oleh kombinasi driver yang dimuat. Misalnya, driver tampilan VGA64K hanya mengembalikan mode warna 64K yang dikembalikan dalam daftar mode yang diperoleh dari driver miniport.

DrvGetModes dapat dipanggil sebelum ada PDEV aktif.

Lihat sampel Permedia untuk melihat implementasi kerja DrvGetModes.

Catatan Microsoft Windows Driver Kit (WDK) tidak berisi driver tampilan sampel 3Dlabs Permedia2 (3dlabs.htm ) dan 3Dlabs Permedia3 (Perm3.htm). Anda bisa mendapatkan driver sampel ini dari Windows Server 2003 SP1 Driver Development Kit (DDK), yang dapat Anda unduh dari halaman DDK - Windows Driver Development Kit dari situs web WDHC.