Fungsi NtGdiDdCreateSurfaceObject

[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 objek permukaan mode kernel yang mewakili objek permukaan mode pengguna yang direferensikan oleh puSurfaceLocal.

Sintaks

HANDLE APIENTRY NtGdiDdCreateSurfaceObject(
  _In_ HANDLE             hDirectDrawLocal,
  _In_ HANDLE             hSurface,
  _In_ PDD_SURFACE_LOCAL  puSurfaceLocal,
  _In_ PDD_SURFACE_MORE   puSurfaceMore,
  _In_ PDD_SURFACE_GLOBAL puSurfaceGlobal,
  _In_ BOOL               bComplete
);

Parameter

hDirectDrawLocal [in]

Tangani ke objek DirectDraw mode kernel.

hSurface [in]

Handel sebelumnya ke permukaan yang sama. Digunakan jika permukaan sedang dibuat ulang setelah pengalihan mode.

puSurfaceLocal [in]

Arahkan ke struktur DD_SURFACE_LOCAL yang mewakili objek permukaan mode pengguna DirectDraw untuk mengaitkan memori yang dialokasikan. Lihat dokumentasi DDK untuk detailnya.

puSurfaceMore [in]

Arahkan ke struktur DD_SURFACE_MORE yang berisi data lokal tambahan untuk setiap objek permukaan individual. Lihat dokumentasi DDK untuk detailnya.

puSurfaceGlobal [in]

Arahkan ke struktur DD_SURFACE_GLOBAL yang berisi data permukaan yang dibagikan secara global dengan beberapa permukaan. Lihat dokumentasi DDK untuk detailnya.

bComplete [in]

Bendera penyelesaian objek mode kernel. Bisa menjadi salah satu nilai berikut.

(BENAR)

Selesaikan semua pemrosesan mengenai representasi mode kernel.

(FALSE)

Buat objek , tetapi jangan siapkan data internal seperti penunjuk memori. Objek yang dibuat menggunakan FALSE dapat dilampirkan menggunakan NtGdiDdAttachSurface dan diselesaikan dengan panggilan ke NtGdiDdCreateSurface.

Menampilkan nilai

Jika berhasil, fungsi ini mengembalikan handel ke representasi permukaan mode kernel; jika tidak, ia mengembalikan NULL.

Keterangan

Aplikasi disarankan untuk menggunakan API DirectDraw dan Direct3D untuk membuat dan mengelola objek perangkat grafis. Konstruksi ini mengabstraksi proses pembuatan perangkat dengan cara yang disederhanakan dan independen sistem operasi.

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

DdCreateSurfaceObject

NtGdiDdDeleteSurfaceObject

NtGdiDdAttachSurface

NtGdiDdCreateSurface