DirectDraw

Gambaran umum teknologi DirectDraw.

Untuk mengembangkan DirectDraw, Anda memerlukan header ini:

• ddraw.h

Untuk panduan pemrograman untuk teknologi ini, lihat:

• DirectDraw

Fungsi

AddAttachedSurface Melampirkan permukaan z-buffer yang ditentukan ke permukaan ini.
AddOverlayDirtyRect Metode IDirectDrawSurface7::AddOverlayDirtyRect saat ini tidak diimplementasikan.
Blt Melakukan transfer blok bit (bitblt). Metode ini tidak mendukung z-buffering atau alpha blending selama operasi bitblt.
BltBatch Metode IDirectDrawSurface7::BltBatch saat ini tidak diimplementasikan.
BltFast Melakukan bitblt salinan sumber atau bitblt transparan dengan menggunakan kunci warna sumber atau kunci warna tujuan.
ChangeUniquenessValue Memperbarui nilai keunikan secara manual untuk permukaan ini.
Ringkas Metode ini saat ini tidak diterapkan. (IDirectDraw7.Compact)
CreateClipper Membuat objek DirectDrawClipper.
CreatePalette Membuat objek DirectDrawPalette untuk objek DirectDraw ini.
CreateSurface Membuat objek DirectDrawSurface untuk objek DirectDraw ini.
DeleteAttachedSurface Melepaskan satu atau beberapa permukaan yang terpasang.
DirectDrawCreate Membuat instans objek DirectDraw.
DirectDrawCreateClipper Membuat instans objek DirectDrawClipper yang tidak terkait dengan objek DirectDraw.
DirectDrawCreateEx Membuat instans objek DirectDraw yang mendukung set antarmuka Direct3D di DirectX 7.0. Untuk menggunakan fitur Direct3D di DirectX 7.0, buat objek DirectDraw dengan fungsi ini.
DirectDrawEnumerateA Fungsi ini digantikan oleh fungsi DirectDrawEnumerateEx. (ANSI)
DirectDrawEnumerateExA Menghitung semua perangkat DirectDraw yang diinstal di komputer. Entri NULL selalu mengidentifikasi perangkat tampilan utama yang dibagikan dengan GDI. (ANSI)
DirectDrawEnumerateExW Menghitung semua perangkat DirectDraw yang diinstal di komputer. Entri NULL selalu mengidentifikasi perangkat tampilan utama yang dibagikan dengan GDI. (Unicode)
DirectDrawEnumerateW Fungsi ini digantikan oleh fungsi DirectDrawEnumerateEx. (Unicode)
DuplikatSurface Menduplikasi objek DirectDrawSurface.
EnumAttachedSurfaces Menghitung semua permukaan yang melekat pada permukaan ini.
EnumDisplayModes Menghitung semua mode tampilan yang diekspos perangkat keras melalui objek DirectDraw dan yang kompatibel dengan deskripsi permukaan yang disediakan.
EnumOverlayZOrders Menghitung permukaan overlay pada tujuan yang ditentukan. Anda dapat menghitung overlay dalam urutan front-to-back atau back-to-front.
EnumSurfaces Menghitung semua permukaan yang ada atau mungkin yang memenuhi deskripsi permukaan yang ditentukan.
EvaluateMode Digunakan setelah panggilan ke IDirectDraw7::StartModeTest untuk melewati atau gagal setiap mode yang disajikan pengujian dan untuk menelusuri mode hingga pengujian selesai.
Flip Membuat memori permukaan yang terkait dengan permukaan DDSCAPS_BACKBUFFER menjadi terkait dengan permukaan buffer depan.
FlipToGDISurface Membuat permukaan yang ditulis GDI ke permukaan utama.
FreePrivateData Membebaskan data privat yang ditentukan yang terkait dengan permukaan ini.
GetAttachedSurface Mendapatkan permukaan terpasang yang memiliki kemampuan yang ditentukan, dan menaikkan jumlah referensi antarmuka yang diambil.
GetAvailableVidMem Mengambil jumlah total memori tampilan yang tersedia dan jumlah memori tampilan yang saat ini bebas untuk jenis permukaan tertentu.
GetBltStatus Mendapatkan status tentang operasi transfer blok bit (bitblt).
GetCaps Mengambil kemampuan driver perangkat untuk perangkat keras dan lapisan emulasi perangkat keras (HEL).
GetCaps Mengambil kemampuan objek palet.
GetCaps Mengambil kemampuan permukaan ini. Kemampuan ini belum tentu terkait dengan kemampuan perangkat tampilan.
GetClipList Mengambil salinan daftar klip yang terkait dengan objek DirectDrawClipper. Untuk memilih subset daftar klip, Anda bisa meneruskan persegi yang mengklip daftar klip.
GetClipper Mengambil objek DirectDrawClipper yang terkait dengan permukaan ini, dan menaikkan jumlah referensi clipper yang dikembalikan.
GetColorControls Mengambil pengaturan kontrol warna saat ini yang terkait dengan overlay atau permukaan utama.
GetColorKey Mengambil nilai kunci warna untuk permukaan ini.
GetDC Membuat handel yang kompatibel dengan GDI dari konteks perangkat untuk permukaan ini.
GetDDInterface Mengambil antarmuka ke objek DirectDraw yang digunakan untuk membuat permukaan ini.
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.
GetDisplayMode Mengambil mode tampilan saat ini.
GetEntries Mengambil nilai palet dari objek DirectDrawPalette.
GetFlipStatus Mengambil status tentang apakah permukaan ini telah menyelesaikan proses membaliknya.
GetFourCCCodes Mengambil kode empat karakter (FOURCC) yang didukung oleh objek DirectDraw. Metode ini juga dapat mengambil jumlah kode yang didukung.
GetGammaRamp Mengambil tanjakan gamma merah, hijau, dan biru untuk permukaan utama.
GetGDISurface Mengambil objek DirectDrawSurface yang saat ini mewakili memori permukaan yang diperlakukan GDI sebagai permukaan utama.
GetHWnd Mengambil handel jendela yang sebelumnya terkait dengan objek DirectDrawClipper ini dengan metode IDirectDrawClipper::SetHWnd.
GetLOD Mengambil tingkat detail maksimum (LOD) yang saat ini ditetapkan untuk permukaan mipmap terkelola. Metode ini hanya berhasil pada tekstur terkelola.
GetMonitorFrequency Mengambil frekuensi monitor yang dikontrol objek DirectDraw.
GetOverlayPosition Mengambil koordinat tampilan permukaan ini. Metode ini digunakan pada permukaan overlay aktif yang terlihat (yaitu, permukaan yang memiliki set bendera DDSCAPS_OVERLAY).
GetPalette Mengambil objek DirectDrawPalette yang terkait dengan permukaan ini, dan menaikkan jumlah referensi palet yang dikembalikan.
GetPixelFormat Mengambil format warna dan piksel permukaan ini.
GetPriority Mengambil prioritas manajemen tekstur untuk tekstur ini. Metode ini hanya berhasil pada tekstur terkelola.
GetPrivateData Menyalin data privat yang terkait dengan permukaan ini ke buffer yang disediakan.
GetScanLine Mengambil baris pemindaian yang saat ini sedang digambar pada monitor.
GetSurfaceDesc Mengambil deskripsi permukaan ini dalam kondisinya saat ini.
GetSurfaceFromDC Mengambil antarmuka IDirectDrawSurface7 untuk permukaan, berdasarkan handel konteks perangkat GDI-nya.
GetUniquenessValue Mengambil nilai keunikan saat ini untuk permukaan ini.
GetVerticalBlankStatus Mengambil status kosong vertikal.
Initialize Menginisialisasi objek DirectDraw yang dibuat dengan menggunakan fungsi CoCreateInstance COM.
Initialize Menginisialisasi objek DirectDrawClipper yang dibuat dengan menggunakan fungsi CoCreateInstance COM.
Initialize Menginisialisasi objek DirectDrawPalette.
Initialize Menginisialisasi objek DirectDrawSurface.
IsClipListChanged Mengambil status daftar klip jika handel jendela dikaitkan dengan objek DirectDrawClipper.
IsLost Menentukan apakah memori permukaan yang terkait dengan objek DirectDrawSurface telah dibebaskan.
Lock Mendapatkan pointer ke memori permukaan.
LPDDENUMCALLBACKA Fungsi DDEnumCallback adalah fungsi panggilan balik yang ditentukan aplikasi untuk fungsi DirectDrawEnumerate. (ANSI)
LPDDENUMCALLBACKEXA Fungsi DDEnumCallbackEx adalah fungsi panggilan balik yang ditentukan aplikasi untuk fungsi DirectDrawEnumerateEx. (ANSI)
LPDDENUMCALLBACKEXW Fungsi DDEnumCallbackEx adalah fungsi panggilan balik yang ditentukan aplikasi untuk fungsi DirectDrawEnumerateEx. (Unicode)
LPDDENUMCALLBACKW Fungsi DDEnumCallback adalah fungsi panggilan balik yang ditentukan aplikasi untuk fungsi DirectDrawEnumerate. (Unicode)
LPDDENUMMODESCALLBACK Jangan gunakan. Fungsi panggilan balik ini digantikan oleh fungsi EnumModesCallback2 yang digunakan dengan metode IDirectDraw7::EnumDisplayModes.
LPDDENUMMODESCALLBACK2 Fungsi EnumModesCallback2 adalah fungsi panggilan balik yang ditentukan aplikasi untuk metode IDirectDraw7::EnumDisplayModes.
LPDDENUMSURFACESCALLBACK Fungsi LPDDENUMSURFACESCALLBACK (ddraw.h) digantikan oleh fungsi EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK2 Fungsi LPDDENUMSURFACESCALLBACK2 (ddraw.h) digantikan oleh fungsi EnumSurfacesCallback7.
LPDDENUMSURFACESCALLBACK7 Fungsi EnumSurfacesCallback7 adalah fungsi panggilan balik yang ditentukan aplikasi untuk metode IDirectDrawSurface7::EnumAttachedSurfaces dan IDirectDrawSurface7::EnumOverlayZOrders.
PageLock Mencegah permukaan memori sistem di-page out saat operasi transfer blok bit (bitblt) yang menggunakan transfer akses memori langsung (DMA) ke atau dari memori sistem sedang berlangsung.
PageUnlock Membuka permukaan memori sistem, yang kemudian memungkinkannya untuk di-page out.
ReleaseDC Merilis handel konteks perangkat yang sebelumnya diperoleh dengan menggunakan metode IDirectDrawSurface7::GetDC.
Memulihkan Memulihkan permukaan yang telah hilang. Ini terjadi ketika memori permukaan yang terkait dengan objek DirectDrawSurface telah dibebaskan.
RestoreAllSurfaces Memulihkan semua permukaan yang dibuat untuk objek DirectDraw, dalam urutan pembuatannya.
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.
SetClipList Mengatur atau menghapus daftar klip yang digunakan oleh metode IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch, dan IDirectDrawSurface7::UpdateOverlay pada permukaan tempat objek DirectDrawClipper induk terpasang.
SetClipper Melampirkan objek clipper ke, atau menghapusnya dari permukaan ini.
SetColorControls Mengatur opsi kontrol warna untuk overlay atau permukaan utama.
SetColorKey Mengatur nilai kunci warna untuk objek DirectDrawSurface jika perangkat keras mendukung kunci warna per permukaan.
SetCooperativeLevel Menentukan perilaku tingkat atas aplikasi.
SetDisplayMode Mengatur mode perangkat keras perangkat tampilan.
SetEntries Mengubah entri dalam objek DirectDrawPalette segera.
SetGammaRamp Mengatur landai gamma merah, hijau, dan biru untuk permukaan utama.
SetHWnd Menyetel handel jendela yang digunakan objek clipper untuk mendapatkan informasi kliping.
SetLOD Mengatur tingkat detail maksimum (LOD) untuk permukaan mipmap terkelola. Metode ini hanya berhasil pada tekstur terkelola.
SetOverlayPosition Mengubah koordinat tampilan permukaan overlay.
SetPalette Melampirkan objek palet ke (atau melepaskan satu dari) permukaan. Permukaan menggunakan palet ini untuk semua operasi berikutnya. Perubahan palet segera terjadi, tanpa memperhatikan pengaturan waktu refresh.
SetPriority Menetapkan prioritas manajemen tekstur untuk tekstur ini. Metode ini hanya berhasil pada tekstur terkelola.
SetPrivateData Mengaitkan data dengan permukaan yang dimaksudkan untuk digunakan oleh aplikasi, bukan oleh DirectDraw. Data diteruskan oleh nilai, dan beberapa set data dapat dikaitkan dengan satu permukaan.
SetSurfaceDesc Mengatur karakteristik permukaan yang ada.
StartModeTest Memulai pengujian untuk memperbarui registri sistem dengan informasi laju refresh untuk adaptor tampilan saat ini dan kombinasi monitor.
TestCooperativeLevel Melaporkan status tingkat kooperatif perangkat DirectDraw saat ini untuk aplikasi berjendela atau layar penuh.
Unlock Memberi tahu DirectDraw bahwa manipulasi permukaan langsung selesai.
UpdateOverlay Memposisikan ulang atau memodifikasi atribut visual permukaan overlay. Permukaan ini harus memiliki bendera DDSCAPS_OVERLAY yang ditetapkan.
UpdateOverlayDisplay Metode IDirectDrawSurface7::UpdateOverlayDisplay saat ini tidak diimplementasikan.
UpdateOverlayZOrder Mengatur urutan z dari overlay.
WaitForVerticalBlank Membantu aplikasi menyinkronkan dirinya dengan interval kosong vertikal.

Antarmuka

IDirectDraw7 Aplikasi menggunakan metode antarmuka IDirectDraw7 untuk membuat objek DirectDraw dan bekerja dengan variabel tingkat sistem. Bagian ini adalah referensi ke metode antarmuka IDirectDraw7.
IDirectDrawClipper Aplikasi menggunakan metode antarmuka IDirectDrawClipper untuk mengelola daftar klip. Bagian ini adalah referensi ke metode antarmuka ini.
IDirectDrawColorControl Aplikasi menggunakan metode antarmuka IDirectDrawColorControl untuk mendapatkan dan mengatur kontrol warna.
IDirectDrawGammaControl Aplikasi menggunakan metode antarmuka IDirectDrawGammaControl untuk menyesuaikan tingkat ramp gamma merah, hijau, dan biru dari permukaan utama. Bagian ini adalah referensi ke metode antarmuka ini.
IDirectDrawPalette Aplikasi menggunakan metode antarmuka IDirectDrawPalette untuk membuat objek DirectDrawPalette dan bekerja dengan variabel tingkat sistem. Bagian ini adalah referensi ke metode antarmuka ini.
IDirectDrawSurface7 Aplikasi menggunakan metode antarmuka IDirectDrawSurface7 untuk membuat objek DirectDrawSurface dan bekerja dengan variabel tingkat sistem. Bagian ini adalah referensi ke metode antarmuka ini.

Struktur

DDCOLORCONTROL Struktur DDCOLORCONTROL menentukan kontrol warna yang terkait dengan objek ekstensi port video (VPE) Microsoft DirectDraw.
DDSURFACEDESC Struktur DDSURFACEDESC berisi deskripsi permukaan yang akan dibuat oleh driver.
DDSURFACEDESC2 Struktur DDSURFACEDESC2 berisi deskripsi permukaan yang akan dibuat oleh driver.
DDBLTBATCH Struktur DDBLTBATCH meneruskan operasi transfer blok bit (bitblt) ke metode IDirectDrawSurface7::BltBatch.
DDBLTFX Struktur DDBLTFX melewati operasi raster (ROP), efek, dan mengambil alih informasi ke metode IDirectDrawSurface7::Blt. Struktur ini juga merupakan bagian dari struktur DDBLTBATCH yang digunakan dengan metode IDirectDrawSurface7::BltBatch.
DDCAPS_DX3 Struktur DDCAPS_DX3 (ddraw.h) mewakili kemampuan perangkat keras yang diekspos melalui objek DirectDraw.
DDCAPS_DX5 Struktur DDCAPS_DX5 (ddraw.h) mewakili kemampuan perangkat keras yang diekspos melalui objek DirectDraw.
DDCAPS_DX6 Struktur DDCAPS_DX6 (ddraw.h) mewakili kemampuan perangkat keras yang diekspos melalui objek DirectDraw.
DDCAPS_DX7 Struktur DDCAPS_DX7 (ddraw.h) mewakili kemampuan perangkat keras yang diekspos melalui objek DirectDraw.
DDCOLORKEY Struktur DDCOLORKEY menjelaskan kunci warna sumber, kunci warna tujuan, atau ruang warna.
DDDEVICEIDENTIFIER2 Struktur DDDEVICEIDENTIFIER2 diteruskan ke metode IDirectDraw7::GetDeviceIdentifier untuk mendapatkan informasi tentang perangkat.
DDGAMMARAMP Struktur DDGAMMARAMP berisi data ramp merah, hijau, dan biru untuk metode IDirectDrawGammaControl::GetGammaRamp dan IDirectDrawGammaControl::SetGammaRamp.
DDOVERLAYFX Struktur DDOVERLAYFX meneruskan informasi overlay ke metode IDirectDrawSurface7::UpdateOverlay.
DDPIXELFORMAT Struktur DDPIXELFORMAT menjelaskan format piksel objek DirectDrawSurface untuk metode IDirectDrawSurface7::GetPixelFormat.
DDSCAPS Struktur DDSCAPS mendefinisikan kemampuan objek permukaan Microsoft DirectDraw.
DDSCAPS2 Struktur DDSCAPS2 mendefinisikan kemampuan tambahan dari objek permukaan Microsoft DirectDraw.