Fungsi DrvGetDirectDrawInfo (winddi.h)

Artikel
08/27/2023

Fungsi DrvGetDirectDrawInfo mengembalikan kemampuan perangkat keras grafis.

Sintaks

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Parameter

dhpdev

Tangani ke PDEV yang dikembalikan oleh rutinitas DrvEnablePDEV driver.

pHalInfo

Menunjuk ke struktur DD_HALINFO di mana driver harus mengembalikan kemampuan perangkat keras yang didukungnya.

pdwNumHeaps

Menunjuk ke lokasi di mana driver harus mengembalikan jumlah struktur VIDEOMEMORY yang diacu oleh pvmList.

pvmList

Menunjuk ke array struktur VIDEOMEMORY di mana driver harus mengembalikan informasi tentang setiap gugus memori tampilan yang dikontrolnya. Driver harus mengabaikan parameter ini ketika NULL.

pdwNumFourCCCodes

Menunjuk ke lokasi di mana driver harus mengembalikan jumlah DWORD yang diarahkan oleh pdwFourCC.

pdwFourCC

Menunjuk ke array DWORD di mana driver harus mengembalikan informasi tentang setiap FOURCC yang didukungnya. Driver harus mengabaikan parameter ini ketika NULL.

Nilai kembali

DrvGetDirectDrawInfo mengembalikan TRUE jika berhasil; jika tidak, ia mengembalikan FALSE.

Keterangan

Rutinitas DrvGetDirectDrawInfo driver harus melakukan hal berikut:

Ketika pvmList dan pdwFourCCADALAH NULL:
1. Cadangkan memori tampilan di luar layar untuk penggunaan DirectDraw.
2. Tulis jumlah tumpukan memori tampilan driver dan FOURCC yang didukung di pdwNumHeaps dan pdwNumFourCC.
Ketika pvmList dan pdwFourCC bukan NULL:
1. Tulis jumlah tumpukan memori tampilan driver dan FOURCC yang didukung di pdwNumHeaps dan pdwNumFourCC.
2. Untuk setiap struktur VIDEOMEMORY dalam daftar tempat pvmList menunjuk, isi anggota yang sesuai untuk menjelaskan potongan memori tampilan tertentu. Daftar struktur menyediakan DirectDraw dengan deskripsi lengkap tentang memori di luar layar driver.
Inisialisasi anggota struktur DD_HALINFO dengan informasi khusus driver sebagai berikut:
1. Inisialisasi anggota struktur VIDEOMEMORYINFO yang sesuai di vmiData untuk menggambarkan karakteristik umum memori tampilan.
2. Inisialisasi anggota struktur DDCORECAPS yang sesuai di ddCaps untuk menjelaskan kemampuan perangkat keras.
3. Jika driver menerapkan fungsi DdGetDriverInfo , atur GetDriverInfo untuk mengarahkannya dan mengatur dwFlags ke DDHALINFO_GETDRIVERINFOSET.