Metode IDirectDraw7::CreateClipper (ddraw.h)

Membuat objek DirectDrawClipper.

Sintaks

HRESULT CreateClipper(
  [in]  DWORD               unnamedParam1,
  [out] LPDIRECTDRAWCLIPPER *unnamedParam2,
  [in]  IUnknown            *unnamedParam3
);

Parameter

[in] unnamedParam1

Saat ini tidak digunakan dan harus diatur ke 0.

[out] unnamedParam2

Alamat variabel yang akan diatur ke penunjuk antarmuka IDirectDrawClipper yang valid jika panggilan berhasil.

[in] unnamedParam3

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

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan adalah DD_OK.

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

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOCOOPERATIVELEVELSET
  • DDERR_OUTOFMEMORY

Keterangan

Objek DirectDrawClipper dapat dilampirkan ke DirectDrawSurface dan digunakan selama operasi IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch, dan IDirectDrawSurface7::UpdateOverlay .

Untuk membuat objek DirectDrawClipper yang tidak dimiliki oleh objek DirectDraw tertentu, gunakan fungsi DirectDrawCreateClipper .

Persyaratan

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

Lihat juga

IDirectDraw7