Share via

Metode IDirectDrawSurface7::P ageLock (ddraw.h)

  • Artikel

Mencegah permukaan memori sistem di-page out saat operasi transfer blok bit (bitblt) yang menggunakan transfer akses memori langsung (DMA) ke atau dari memori sistem sedang berlangsung.

Sintaks

HRESULT PageLock(
  [in] DWORD unnamedParam1
);

Parameter

[in] unnamedParam1

Saat ini tidak digunakan dan harus diatur ke 0.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan DD_OK.

Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:

  • DDERR_CANTPAGELOCK
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_SURFACELOST

Keterangan

Anda harus memanggil PageLock untuk menggunakan dukungan DMA. Jika tidak, bitblt terjadi dengan menggunakan emulasi perangkat lunak.

Performa sistem operasi dapat terpengaruh secara negatif jika terlalu banyak memori dikunci.

Jumlah kunci dipertahankan untuk setiap permukaan dan bertambah setiap kali PageLock dipanggil untuk permukaan tersebut. Jumlahnya dikurangi ketika IDirectDrawSurface7::P ageUnlock dipanggil. Ketika jumlah mencapai 0, memori tidak terkunci, dan kemudian dapat di-page oleh sistem operasi.

PageLock hanya berfungsi pada permukaan memori sistem; ini tidak mengunci halaman permukaan display-memory atau permukaan primer yang ditiru. Jika aplikasi memanggil PageLock pada permukaan memori tampilan, metode tidak melakukan apa pun kecuali mengembalikan DD_OK.

IDirectDrawSurface7::P ageLock tidak diimplementasikan dalam versi antarmuka IDirectDraw .

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header ddraw.h
Pustaka Ddraw.lib
DLL Ddraw.dll

Lihat juga

IDirectDrawSurface7