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 |