Fungsi NtGdiD3DContextCreate

Artikel
06/13/2023

[Fungsi ini dapat berubah dengan setiap revisi sistem operasi. Sebagai gantinya, gunakan Microsoft DirectDraw dan Microsoft Direct3DAPIs; API ini mengisolasi aplikasi dari perubahan sistem operasi tersebut, dan menyembunyikan banyak kesulitan lain yang terlibat dalam berinteraksi langsung dengan pengandar tampilan.]

Membuat konteks.

Sintaks

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

Parameter

hDirectDrawLocal [in]: Tangani ke objek DirectDraw mode kernel, yang sebelumnya dibuat dengan NtGdiDdCreateDirectDrawObject, yang mewakili perangkat tempat konteks Direct3D akan dibuat.
hSurfColor [in]: Tangani ke struktur DD_SURFACE_LOCAL yang menjelaskan permukaan DirectDraw yang akan digunakan sebagai target penyajian.
hSurfZ [in]: Tangani 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.
pdcci [masuk, keluar]: Arahkan ke struktur D3DNTHAL_CONTEXTCREATEDATA yang berisi informasi yang diperlukan untuk membuat konteks dan data yang harus disimpan driver dalam konteks baru.

Menampilkan nilai

NtGdiD3DContextCreate mengembalikan salah satu kode panggilan balik berikut.

Menampilkan kode	Deskripsi
DDHAL_DRIVER_HANDLED	Driver telah melakukan operasi dan mengembalikan kode pengembalian yang valid untuk operasi tersebut. Jika kode ini DD_OK, DirectDraw atau Direct3D melanjutkan fungsi . Jika tidak, DirectDraw atau Direct3D mengembalikan kode kesalahan yang disediakan oleh driver dan membatalkan fungsi.
DDHAL_DRIVER_NOTHANDLED	Driver tidak memiliki komentar tentang operasi yang diminta. Jika driver diharuskan menerapkan panggilan balik tertentu, DirectDraw atau Direct3D melaporkan kondisi kesalahan. Jika tidak, DirectDraw atau Direct3D menangani operasi seolah-olah panggilan balik driver belum ditentukan dengan menjalankan implementasi independen perangkat DirectDraw atau Direct3D.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Ntgdi.h

Lihat juga

Dukungan Klien Tingkat Rendah Grafis

Share via