Fungsi DirectDrawCreateClipper (ddraw.h)

Membuat instans objek DirectDrawClipper yang tidak terkait dengan objek DirectDraw.

Sintaks

HRESULT DirectDrawCreateClipper(
  [in]  DWORD               dwFlags,
  [out] LPDIRECTDRAWCLIPPER *lplpDDClipper,
  [in]  IUnknown            *pUnkOuter
);

Parameter

[in] dwFlags

Saat ini tidak digunakan dan harus diatur ke 0.

[out] lplpDDClipper

Alamat pointer yang akan diisi dengan alamat objek DirectDrawClipper baru.

[in] pUnkOuter

Memungkinkan kompatibilitas di masa mendatang dengan fitur agregasi COM. Saat ini, fungsi ini mengembalikan kesalahan jika parameter ini bukan NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah DD_OK.

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

• DDERR_INVALIDPARAMS
• DDERR_OUTOFMEMORY

Keterangan

Anda dapat memanggil DirectDrawCreateClipper sebelum objek DirectDraw dibuat. Karena objek DirectDrawClipper ini tidak dimiliki oleh objek DirectDraw apa pun, objek tersebut tidak secara otomatis dirilis ketika objek aplikasi dirilis. Jika aplikasi tidak secara eksplisit merilis objek DirectDrawClipper, DirectDraw merilisnya saat aplikasi berakhir.

Untuk membuat objek DirectDrawClipper yang dimiliki oleh objek DirectDraw tertentu, gunakan metode IDirectDraw7::CreateClipper .

Anda harus menggunakan LoadLibrary untuk secara eksplisit menautkan ke Ddraw.dll lalu menggunakan GetProcAddress untuk mengakses fungsi DirectDrawCreateClipper .

Persyaratan

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