Metode IDirect3D9Ex::CreateDeviceEx (d3d9.h)

Membuat perangkat untuk mewakili adaptor tampilan.

Sintaks

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

Parameter

[in] Adapter

Jenis: UINT

Nomor urut yang menunjukkan adaptor tampilan. D3DADAPTER_DEFAULT selalu merupakan adaptor tampilan utama.

[in] DeviceType

Jenis: D3DDEVTYPE

Menentukan jenis perangkat. Lihat D3DDEVTYPE. Jika jenis perangkat yang diinginkan tidak tersedia, metode akan gagal.

[in] hFocusWindow

Jenis: HWND

Jendela fokus memperingatkan Direct3D saat aplikasi beralih dari mode latar depan ke mode latar belakang. Untuk mode layar penuh, jendela yang ditentukan harus merupakan jendela tingkat atas. Untuk mode berjendela, parameter ini mungkin NULL hanya jika anggota hDeviceWindow dari pPresentationParameters diatur ke nilai non-NULL yang valid.

[in] BehaviorFlags

Jenis: DWORD

Kombinasi satu atau beberapa opsi (lihat D3DCREATE) yang mengontrol pembuatan perangkat.

[in, out] pPresentationParameters

Jenis: D3DPRESENT_PARAMETERS*

Arahkan ke struktur D3DPRESENT_PARAMETERS , yang menjelaskan parameter presentasi untuk perangkat yang akan dibuat. Jika BehaviorFlags menentukan D3DCREATE_ADAPTERGROUP_DEVICE, parameter ini adalah array. Terlepas dari jumlah kepala yang ada, hanya satu permukaan kedalaman/stensil yang secara otomatis dibuat.

Parameter ini adalah parameter input dan output. Memanggil metode ini dapat mengubah beberapa anggota termasuk:

• Jika BackBufferCount, BackBufferWidth, dan BackBufferHeight adalah 0 sebelum metode dipanggil, mereka akan diubah ketika metode kembali.
• Jika BackBufferFormat sama dengan D3DFMT_UNKNOWN sebelum metode dipanggil, itu akan diubah ketika metode kembali.

[in, out] pFullscreenDisplayMode

Jenis: D3DDISPLAYMODEEX*

Mode tampilan ketika perangkat diatur ke layar penuh. Lihat D3DDISPLAYMODEEX. Jika BehaviorFlags menentukan D3DCREATE_ADAPTERGROUP_DEVICE, parameter ini adalah array. Parameter ini harus NULL untuk mode berjendela.

[out, retval] ppReturnedDeviceInterface

Jenis: IDirect3DDevice9Ex**

Alamat pointer ke IDirect3DDevice9Ex yang dikembalikan, yang mewakili perangkat yang dibuat.

Nilai kembali

Jenis: HRESULT

Metode ini mengembalikan S_OK saat penyajian perangkat bersama dengan buffer swapchain berhasil dibuat. D3DERR_DEVICELOST dikembalikan ketika terjadi kesalahan selain input penelepon yang tidak valid.

Persyaratan

Target Platform	Windows
Header	d3d9.h
Pustaka	D3D9.lib

Lihat juga

IDirect3D9Ex