Fungsi Direct3DCreate9 (d3d9.h)
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 |