Fungsi DirectDrawCreate (ddraw.h)

Artikel
02/26/2024

Membuat instans objek DirectDraw. Objek DirectDraw yang dibuat dengan menggunakan fungsi ini tidak mendukung set lengkap antarmuka Direct3D di DirectX 7.0. Untuk membuat objek DirectDraw yang mampu mengekspos semua fitur Direct3D di DirectX 7.0, gunakan fungsi DirectDrawCreateEx .

Sintaks

HRESULT DirectDrawCreate(
  [in]  GUID         *lpGUID,
  [out] LPDIRECTDRAW *lplpDD,
  [in]  IUnknown     *pUnkOuter
);

Parameter

[in] lpGUID

Penunjuk ke pengidentifikasi unik global (GUID) yang mewakili driver yang akan dibuat. Ini bisa NULL untuk menunjukkan driver tampilan aktif, atau Anda dapat meneruskan salah satu bendera berikut untuk membatasi perilaku driver tampilan aktif untuk tujuan penelusuran kesalahan:

DDCREATE_EMULATIONONLY

Objek DirectDraw menggunakan emulasi untuk semua fitur; ini tidak memanfaatkan fitur yang didukung perangkat keras apa pun.

DDCREATE_HARDWAREONLY

Objek DirectDraw tidak pernah menimulasi fitur yang tidak didukung oleh perangkat keras. Upaya untuk memanggil metode yang memerlukan fitur yang tidak didukung gagal, mengembalikan DDERR_UNSUPPORTED.

[out] lplpDD

Penunjuk ke variabel yang akan diatur ke penunjuk antarmuka IDirectDraw yang valid jika panggilan berhasil.

[in] pUnkOuter

Memungkinkan kompatibilitas di masa mendatang dengan fitur agregasi COM. Namun, saat ini, fungsi ini mengembalikan kesalahan jika parameter ini tidak lain adalah NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan DD_OK.

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

DDERR_DIRECTDRAWALREADYCREATED
DDERR_GENERIC
DDERR_INVALIDDIRECTDRAWGUID
DDERR_INVALIDPARAMS
DDERR_NODIRECTDRAWHW
DDERR_OUTOFMEMORY

Keterangan

Fungsi ini mencoba menginisialisasi objek DirectDraw, lalu mengatur penunjuk ke objek jika panggilan berhasil.

Pada komputer dengan beberapa monitor, jika Anda menentukan NULL untuk lpGUID, objek DirectDraw berjalan dalam mode emulasi ketika tingkat kooperatif normal diatur. Untuk menggunakan akselerasi perangkat keras pada komputer ini, tentukan GUID perangkat.

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

Persyaratan

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

Bagikan melalui