Fungsi DirectDrawCreateEx (ddraw.h)

Membuat instans objek DirectDraw yang mendukung kumpulan antarmuka Direct3D di DirectX 7.0. Untuk menggunakan fitur Direct3D di DirectX 7.0, buat objek DirectDraw dengan fungsi ini.

Sintaks

HRESULT DirectDrawCreateEx(
  [in]  GUID     *lpGuid,
  [out] LPVOID   *lplpDD,
  [in]  REFIID   iid,
  [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 menilui 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 IDirectDraw7 yang valid jika panggilan berhasil.

[in] iid

Parameter ini harus diatur ke IID_IDirectDraw7. Fungsi ini gagal dan mengembalikan DDERR_INVALIDPARAMS jika ada antarmuka lain yang ditentukan.

[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_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 DirectDrawCreateEx .

Persyaratan

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