Fungsi NtGdiDdCreateSurfaceEx

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

Membuat permukaan Microsoft Direct3D dari permukaan Microsoft DirectDraw dan mengaitkan nilai handel yang diminta ke permukaan tersebut.

Sintaks

DWORD APIENTRY NtGdiDdCreateSurfaceEx(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ DWORD  dwSurfaceHandle
);

Parameter

hDirectDraw [in]

Tangani ke objek DirectDraw yang dibuat oleh aplikasi.

hSurface [in]

Tangani ke permukaan DirectDraw yang akan dibuat untuk Direct3D. Handel ini unik dalam setiap struktur DD_DIRECTDRAW_LOCAL yang berbeda.

dwSurfaceHandle [in]

Tangani ke struktur DD_CREATESURFACEEXDATA yang berisi informasi yang diperlukan driver untuk membuat permukaan.

Menampilkan nilai

NtGdiDdCreateSurfaceEx 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 mengeksekusi 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