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)

Lihat juga

D3dContextCreate

DD_DIRECTDRAW_LOCAL

DD_SURFACE_LOCAL