struktur DDSURFACEDESC2 (ddraw.h)

Struktur DDSURFACEDESC2 berisi deskripsi permukaan yang akan dibuat oleh driver.

Sintaks

typedef struct _DDSURFACEDESC2 {
  DWORD      dwSize;
  DWORD      dwFlags;
  DWORD      dwHeight;
  DWORD      dwWidth;
#if ...
  union {
    LONG  lPitch;
    DWORD dwLinearSize;
  } DUMMYUNIONNAMEN;
#elif
  union {
    DWORD dwBackBufferCount;
    DWORD dwDepth;
  } DUMMYUNIONNAMEN;
#elif
  union {
    DWORD dwMipMapCount;
    DWORD dwRefreshRate;
    DWORD dwSrcVBHandle;
  } DUMMYUNIONNAMEN;
  DWORD      dwAlphaBitDepth;
  DWORD      dwReserved;
  LPVOID     lpSurface;
#elif
  union {
    DDCOLORKEY ddckCKDestOverlay;
    DWORD      dwEmptyFaceColor;
  } DUMMYUNIONNAMEN;
  DDCOLORKEY ddckCKDestBlt;
  DDCOLORKEY ddckCKSrcOverlay;
  DDCOLORKEY ddckCKSrcBlt;
#else
  union {
    DDPIXELFORMAT ddpfPixelFormat;
    DWORD         dwFVF;
  } DUMMYUNIONNAMEN;
#endif
  DDSCAPS2   ddsCaps;
  DWORD      dwTextureStage;
} *LPDDSURFACEDESC2, DDSURFACEDESC2;

Anggota

dwSize

Menentukan ukuran dalam byte dari struktur DDSURFACEDESC2 ini. Anggota ini harus diinisialisasi sebelum struktur digunakan.

dwFlags

Menentukan sekumpulan bendera yang menentukan anggota struktur DDSURFACEDESC2 apa yang berisi data yang valid. Anggota ini bisa menjadi satu atau beberapa bendera berikut:

Bendera	Makna
DDSD_ALL	Semua anggota input berisi data yang valid.
DDSD_ALPHABITDEPTH	Anggota dwAlphaBitDepth valid.
DDSD_BACKBUFFERCOUNT	Anggota dwBackBufferCount valid.
DDSD_CAPS	Anggota ddsCaps valid.
DDSD_CKDESTBLT	Anggota ddckCKDestBlt valid.
DDSD_CKDESTOVERLAY	Anggota ddckCKDestOverlay valid.
DDSD_CKSRCBLT	Anggota ddckCKSrcBlt valid.
DDSD_CKSRCOVERLAY	Anggota ddckCKSrcOverlay valid.
DDSD_FVF	Anggota dwFVF valid.
DDSD_HEIGHT	Anggota dwHeight valid.
DDSD_LINEARSIZE	Anggota dwLinearSize valid.
DDSD_LPSURFACE	Anggota lpSurface valid.
DDSD_MIPMAPCOUNT	Anggota dwMipMapCount valid.
DDSD_PITCH	Anggota lPitch valid.
DDSD_PIXELFORMAT	Anggota ddpfPixelFormat valid.
DDSD_REFRESHRATE	Anggota dwRefreshRate valid.
DDSD_SRCVBHANDLE	Anggota dwSrcVBHandle valid.
DDSD_TEXTURESTAGE	Anggota dwTextureStage valid.
DDSD_WIDTH	Anggota dwWidth valid.
DDSD_ZBUFFERBITDEPTH	Bendera ini tidak digunakan dalam DDSURFACEDESC2. Ini hanya digunakan dalam DDSURFACEDESC.

dwHeight

Menentukan tinggi permukaan dalam piksel.

dwWidth

Menentukan lebar permukaan dalam piksel.

DUMMYUNIONNAMEN

T/A

DUMMYUNIONNAMEN.lPitch

Menentukan jumlah byte antara awal dua baris pemindaian yang berdekatan; yaitu, jumlah byte yang akan ditambahkan ke alamat awal satu baris pemindaian untuk mencapai alamat awal baris pemindaian berikutnya di bawahnya. Panggilan balik DdCreateSurface driver harus mengembalikan nilai ini.

DUMMYUNIONNAMEN.dwLinearSize

Menentukan ukuran dalam byte permukaan yang tidak berdaya, terlambat dialokasikan, dan dioptimalkan.

DUMMYUNIONNAMEN.dwBackBufferCount

Menentukan jumlah buffer belakang yang terkait dengan permukaan.

DUMMYUNIONNAMEN.dwDepth

Kedalaman bit jika ini adalah tekstur volume.

DUMMYUNIONNAMEN.dwMipMapCount

Menentukan jumlah tingkat mipmap.

DUMMYUNIONNAMEN.dwRefreshRate

Menentukan laju refresh di hertz monitor (digunakan saat mode tampilan dijelaskan).

DUMMYUNIONNAMEN.dwSrcVBHandle

Menentukan sumber yang digunakan dalam IDirect3DVertexBuffer7::Optimize (dijelaskan dalam dokumentasi Microsoft Direct3D SDK).

dwAlphaBitDepth

Menentukan kedalaman buffer alfa dalam bit per piksel.

dwReserved

Dicadangkan, dan harus diatur ke nol.

lpSurface

Menentukan alamat memori permukaan terkait.

DUMMYUNIONNAMEN.ddckCKDestOverlay

Menentukan kunci warna untuk penggunaan overlay tujuan.

DUMMYUNIONNAMEN.dwEmptyFaceColor

Menentukan warna fisik untuk wajah peta kubus kosong.

ddckCKDestBlt

Menentukan kunci warna untuk penggunaan blit tujuan.

ddckCKSrcOverlay

Menentukan kunci warna untuk penggunaan overlay sumber.

ddckCKSrcBlt

Menentukan kunci warna untuk penggunaan blit sumber.

DUMMYUNIONNAMEN.ddpfPixelFormat

Menentukan struktur DDPIXELFORMAT yang menjelaskan format piksel permukaan.

DUMMYUNIONNAMEN.dwFVF

Menentukan Format Verteks Fleksibel (D3DFVF) untuk buffer vertex.

ddsCaps

Menentukan struktur DDSCAPS yang berisi kemampuan permukaan DirectDraw.

dwTextureStage

Menentukan tahap dalam kaskade multitekstur. Untuk informasi selengkapnya, lihat Tahapan Tekstur.

Keterangan

Anggota yang relevan berbeda untuk setiap jenis permukaan potensial. Struktur ini biasanya dibuat dan diinisialisasi oleh aplikasi.

Persyaratan

Persyaratan	Nilai
Header	ddraw.h

Lihat juga

• DdCreateSurface
• DDPIXELFORMAT
• DDSCAPS