Antarmuka IDirectDraw7 (ddraw.h)

Aplikasi menggunakan metode antarmuka IDirectDraw7 untuk membuat objek DirectDraw dan bekerja dengan variabel tingkat sistem. Bagian ini adalah referensi ke metode antarmuka IDirectDraw7 .

Warisan

Antarmuka IDirectDraw7 mewarisi dari antarmuka IUnknown . IDirectDraw7 juga memiliki jenis anggota ini:

Metode

Antarmuka IDirectDraw7 memiliki metode ini.

IDirectDraw7::Compact Metode ini saat ini tidak diterapkan. (IDirectDraw7.Compact)
IDirectDraw7::CreateClipper Membuat objek DirectDrawClipper.
IDirectDraw7::CreatePalette Membuat objek DirectDrawPalette untuk objek DirectDraw ini.
IDirectDraw7::CreateSurface Membuat objek DirectDrawSurface untuk objek DirectDraw ini.
IDirectDraw7::D uplicateSurface Menduplikasi objek DirectDrawSurface.
IDirectDraw7::EnumDisplayModes Menghitung semua mode tampilan yang diekspos perangkat keras melalui objek DirectDraw dan yang kompatibel dengan deskripsi permukaan yang disediakan.
IDirectDraw7::EnumSurfaces Menghitung semua permukaan yang ada atau mungkin yang memenuhi deskripsi permukaan yang ditentukan.
IDirectDraw7::EvaluateMode Digunakan setelah panggilan ke IDirectDraw7::StartModeTest untuk melewati atau gagal setiap mode yang disajikan pengujian dan untuk menelusuri mode hingga pengujian selesai.
IDirectDraw7::FlipToGDISurface Membuat permukaan yang ditulis GDI ke permukaan utama.
IDirectDraw7::GetAvailableVidMem Mengambil jumlah total memori tampilan yang tersedia dan jumlah memori tampilan yang saat ini bebas untuk jenis permukaan tertentu.
IDirectDraw7::GetCaps Mengambil kemampuan driver perangkat untuk perangkat keras dan lapisan emulasi perangkat keras (HEL).
IDirectDraw7::GetDeviceIdentifier Mendapatkan informasi tentang driver perangkat. Metode ini dapat digunakan, dengan hati-hati, untuk mengenali penginstalan perangkat keras tertentu untuk menerapkan solusi untuk perilaku driver atau chipset yang buruk.
IDirectDraw7::GetDisplayMode Mengambil mode tampilan saat ini.
IDirectDraw7::GetFourCCCodes Mengambil kode empat karakter (FOURCC) yang didukung oleh objek DirectDraw. Metode ini juga dapat mengambil jumlah kode yang didukung.
IDirectDraw7::GetGDISurface Mengambil objek DirectDrawSurface yang saat ini mewakili memori permukaan yang diperlakukan GDI sebagai permukaan utama.
IDirectDraw7::GetMonitorFrequency Mengambil frekuensi monitor yang dikontrol objek DirectDraw.
IDirectDraw7::GetScanLine Mengambil baris pemindaian yang saat ini sedang digambar pada monitor.
IDirectDraw7::GetSurfaceFromDC Mengambil antarmuka IDirectDrawSurface7 untuk permukaan, berdasarkan handel konteks perangkat GDI-nya.
IDirectDraw7::GetVerticalBlankStatus Mengambil status kosong vertikal.
IDirectDraw7::Initialize Menginisialisasi objek DirectDraw yang dibuat dengan menggunakan fungsi CoCreateInstance COM.
IDirectDraw7::RestoreAllSurfaces Memulihkan semua permukaan yang dibuat untuk objek DirectDraw, dalam urutan pembuatannya.
IDirectDraw7::RestoreDisplayMode Mengatur ulang mode perangkat keras perangkat tampilan untuk permukaan utama ke apa yang sebelum metode IDirectDraw7::SetDisplayMode dipanggil. Akses tingkat eksklusif diperlukan untuk menggunakan metode ini.
IDirectDraw7::SetCooperativeLevel Menentukan perilaku tingkat atas aplikasi.
IDirectDraw7::SetDisplayMode Mengatur mode perangkat keras perangkat-tampilan.
IDirectDraw7::StartModeTest Memulai pengujian untuk memperbarui registri sistem dengan informasi laju refresh untuk adaptor tampilan saat ini dan kombinasi monitor.
IDirectDraw7::TestCooperativeLevel Melaporkan status tingkat koperasi perangkat DirectDraw saat ini untuk aplikasi berjendela atau layar penuh.
IDirectDraw7::WaitForVerticalBlank Membantu aplikasi menyinkronkan dirinya dengan interval kosong vertikal.

Keterangan

Metode antarmuka IDirectDraw7 dapat diatur ke dalam grup berikut:

Grup	Metode
Mengalokasikan memori	Padatkan dan Inisialisasi
Tingkat koperasi	SetCooperativeLevel dan TestCooperativeLevel
Membuat objek-objek	CreateClipper, CreatePalette, dan CreateSurface
Kemampuan perangkat	GetCaps
Tampilkan mode	EnumDisplayModes, GetDisplayMode, GetMonitorFrequency, RestoreDisplayMode, SetDisplayMode, dan WaitForVerticalBlank
Tampilkan status	GetScanLine dan GetVerticalBlankStatus
Lain-lain	EvaluateMode, GetAvailableVidMem, GetDeviceIdentifier, GetFourCCCodes, dan StartModeTest
Manajemen permukaan	DuplicateSurface, EnumSurfaces, FlipToGDISurface, GetGDISurface, GetSurfaceFromDC, dan RestoreAllSurfaces

 

Antarmuka IDirectDraw7 memperluas fitur versi antarmuka sebelumnya dengan menawarkan metode yang memungkinkan manajemen permukaan yang lebih fleksibel daripada versi sebelumnya. Semua metode terkait permukaan di antarmuka IDirectDraw7 menerima parameter yang sedikit berbeda dari rekan-rekan mereka di antarmuka IDirectDraw2 . Di mana pun metode antarmuka IDirectDraw2 mungkin menerima struktur DDSURFACEDESC dan mengambil antarmuka IDirectDrawSurface3 , metode dalam IDirectDraw7 menerima struktur DDSURFACEDESC2 dan mengambil antarmuka IDirectDrawSurface7 , sebagai gantinya.

IDirectDraw7 memperkenalkan peningkatan kepatuhan terhadap aturan COM yang menentukan masa pakai objek anak.

Gunakan jenis data LPDIRECTDRAW, LPDIRECTDRAW2, LPDIRECTDRAW4, atau LPDIRECTDRAW7 untuk mendeklarasikan variabel yang berisi pointer ke antarmuka IDirectDraw, IDirectDraw2, IDirectDraw4 , atau IDirectDraw7 . File header Ddraw.h mendeklarasikan jenis data ini dengan kode berikut:

typedef struct IDirectDraw     FAR *LPDIRECTDRAW;
typedef struct IDirectDraw2    FAR *LPDIRECTDRAW2;
typedef struct IDirectDraw4    FAR *LPDIRECTDRAW4;
typedef struct IDirectDraw7    FAR *LPDIRECTDRAW7;

Persyaratan

Target Platform	Windows
Header	ddraw.h