struktur D3DHAL_CONTEXTCREATEDATA (d3dhal.h)
Struktur D3DHAL_CONTEXTCREATEDATA berisi semua informasi yang diperlukan fungsi D3dContextCreate untuk membuat konteks baru.
Sintaks
typedef struct _D3DHAL_CONTEXTCREATEDATA {
union {
LPDDRAWI_DIRECTDRAW_GBL lpDDGbl;
LPDDRAWI_DIRECTDRAW_LCL lpDDLcl;
};
union {
LPDIRECTDRAWSURFACE lpDDS;
LPDDRAWI_DDRAWSURFACE_LCL lpDDSLcl;
};
union {
LPDIRECTDRAWSURFACE lpDDSZ;
LPDDRAWI_DDRAWSURFACE_LCL lpDDSZLcl;
};
union {
DWORD dwPID;
ULONG_PTR dwrstates;
};
ULONG_PTR dwhContext;
HRESULT ddrval;
} D3DHAL_CONTEXTCREATEDATA;
Anggota
lpDDGbl
Struktur driver (warisan).
lpDDLcl
Menunjuk ke objek DirectDraw yang harus dibuat aplikasi untuk mengambil Antarmuka COM ke Direct3D. Ini memungkinkan informasi konteks dibagikan antara aplikasi DirectDraw dan driver. lpDDLcl adalah faktor umum dan pengikatan antara konteks aplikasi dan konteks driver. Ini menunjuk ke struktur DD_DIRECTDRAW_LOCAL yang digunakan untuk mengidentifikasi permukaan yang termasuk dalam konteks Direct3D tertentu dan hanya relevan dengan proses DirectDraw saat ini. lpDDLcl diperlukan karena permukaan (misalnya, buffer kedalaman, buffer penyajian, dan tekstur) dapat dibuat sebelum konteks Direct3D pernah dibuat di driver.
lpDDS
Permukaan yang akan digunakan sebagai target.
lpDDSLcl
Menunjuk ke struktur DD_SURFACE_LOCAL yang menjelaskan permukaan DirectDraw yang akan digunakan sebagai target penyajian.
lpDDSZ
Permukaan yang akan digunakan sebagai Z.
lpDDSZLcl
Menunjuk ke struktur DD_SURFACE_LOCAL yang menggambarkan permukaan DirectDraw yang akan digunakan sebagai buffer kedalaman. Jika anggota ini NULL, tidak ada buffer kedalaman yang akan dilakukan.
dwPID
Menentukan ID proses saat ini. Ini adalah ID proses dari aplikasi Direct3D yang memulai pembuatan perangkat Direct3D.
dwrstates
Menunjuk ke array status render yang harus diperbarui driver saat mengurai perintah status render dari buffer perintah. Buffer array harus cukup besar untuk berisi setidaknya jumlah nilai ULONG yang ditentukan.
dwhContext
Menentukan lokasi yang menunjukkan, pada input, versi runtime mode pengguna Direct3D dan, pada output, di mana driver mengembalikan handel konteks setelah berhasil membuat konteks. Lihat Keterangan untuk informasi selengkapnya.
ddrval
Menentukan lokasi tempat driver menulis kode pengembalian untuk D3dContextCreate. Kode pengembalian D3D_OK menunjukkan keberhasilan. Kode pengembalian D3DHAL_OUTOFCONTEXTS menunjukkan bahwa driver tidak dapat membuat konteks. Untuk informasi selengkapnya, lihat Mengembalikan Kode untuk Panggilan Balik Driver Direct3D.
Keterangan
Ketika runtime Direct3D memanggil fungsi D3dContextCreate driver, runtime menentukan angka yang menunjukkan versi mode pengguna runtime di anggota dwhContext . Tabel berikut ini memperlihatkan pemetaan angka dan versi mode pengguna.
| Telepon | Versi mode pengguna DirectX |
|---|---|
| 5 | 9.0 |
| 4 | 8.0 |
| 3 | 7.0 |
| 2 | 6.0 |
| 1 | 5.0 |
| 0 | 3.0 |
Jika driver berhasil membuat konteks, driver mengembalikan ID konteks di dwhContext untuk runtime Direct3D yang akan digunakan saat berkomunikasi dengan driver.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | d3dhal.h (termasuk D3dhal.h) |