Fungsi HeapVidMemAllocAligned (dmemmgr.h)

Artikel
08/23/2023

Fungsi HeapVidMemAllocAligned mengalokasikan off_screen_memory untuk driver tampilan dengan menggunakan manajer timbunan memori video DirectDraw.

Sintaks

FLATPTR HeapVidMemAllocAligned(
  [in]  LPVIDMEM           lpVidMem,
  [in]  DWORD              dwWidth,
  [in]  DWORD              dwHeight,
  [in]  LPSURFACEALIGNMENT lpAlignment,
  [out] LPLONG             lpNewPitch
);

Parameter

[in] lpVidMem

Arahkan ke struktur VIDEOMEMORY yang mewakili tumpukan DirectDraw untuk mengalokasikan permukaan.

[in] dwWidth

Adalah lebar dalam byte dari permukaan yang diminta.

[in] dwHeight

Apakah tinggi dalam garis pemindaian permukaan yang diminta.

[in] lpAlignment

Penunjuk ke struktur SURFACEALIGNMENT yang menjelaskan pembatasan perataan untuk permukaan.

[out] lpNewPitch

Adalah lokasi di mana nilai pitch yang dihasilkan ditulis. Informasi ini hanya relevan untuk timbunan off-screen linear (nonrektangular).

Menampilkan nilai

HeapVidMemAllocAligned mengembalikan offset FLATPTR dari alokasi yang dihasilkan setelah berhasil. Jika tidak, ia mengembalikan nol.

Keterangan

Driver harus menggunakan array VIDEOMEMORY struktur yang diterima fungsi DrvGetDirectDrawInfo untuk menentukan nilai lpVidMem untuk memanggil HeapVidMemAllocAligned. Driver menerima array ini dalam parameter pvmList selama panggilan kedua ke DrvGetDirectDrawInfo. Ada kemungkinan bahwa DrvGetDirectDrawInfo mungkin tidak dipanggil ketika kondisi memori rendah ada pada sistem. Akibatnya, driver harus selalu memeriksa untuk memastikan bahwa driver memiliki penunjuk non-NULL di pvmList.

Persyaratan


Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	dmemmgr.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys

Lihat juga

Bagikan melalui