Bagikan melalui

struktur DDSURFACEDESC2 (ddraw.h)

  • Artikel

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