Fungsi Direct3DCreate9 (d3d9.h)

  • Artikel

Buat objek IDirect3D9 dan kembalikan antarmuka ke dalamnya.

Sintaks

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

Parameter

SDKVersion

Jenis: UINT

Nilai parameter ini harus D3D_SDK_VERSION. Lihat Keterangan.

Mengembalikan nilai

Jenis: IDirect3D9*

Jika berhasil, fungsi ini mengembalikan pointer ke antarmuka IDirect3D9 ; jika tidak, penunjuk NULL dikembalikan.

Keterangan

Objek Direct3D adalah objek COM Direct3D pertama yang perlu dibuat oleh aplikasi grafis Anda dan objek terakhir yang perlu dirilis aplikasi Anda. Fungsi untuk menghitung dan mengambil kemampuan perangkat dapat diakses melalui objek Direct3D. Ini memungkinkan aplikasi untuk memilih perangkat tanpa membuatnya.

Buat objek IDirect3D9 seperti yang diperlihatkan di sini:


LPDIRECT3D9 g_pD3D = NULL;
    
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
    return E_FAIL;

Antarmuka IDirect3D9 mendukung enumerasi adaptor tampilan aktif dan memungkinkan pembuatan objek IDirect3DDevice9 . Jika pengguna secara dinamis menambahkan adaptor (baik dengan menambahkan perangkat ke desktop, atau dengan hot-docking laptop), perangkat tersebut tidak akan disertakan dalam enumerasi. Membuat antarmuka IDirect3D9 baru akan mengekspos perangkat baru.

D3D_SDK_VERSION diteruskan ke fungsi ini untuk memastikan bahwa file header tempat aplikasi dikompilasi cocok dengan versi DLL runtime yang diinstal pada komputer. D3D_SDK_VERSION hanya diubah dalam runtime ketika perubahan header (atau perubahan kode lainnya) akan mengharuskan aplikasi dibangun kembali. Jika fungsi ini gagal, itu menunjukkan bahwa versi file header tidak cocok dengan versi DLL runtime.

Misalnya, lihat Membuat Perangkat (Direct3D 9).

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9.h (termasuk D3D9.h)
Pustaka D3d9.lib
DLL D3d9.dll

Lihat juga

Fungsi Direct3D