Bagikan melalui

struktur DD_CANCREATESURFACEDATA (ddrawint.h)

  • Artikel

Struktur DD_CANCREATESURFACEDATA berisi informasi yang diperlukan untuk menunjukkan apakah permukaan--dalam kasus CanCreateD3DBuffer, buffer--dapat dibuat.

Sintaks

typedef struct _DD_CANCREATESURFACEDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACEDESC       lpDDSurfaceDesc;
  DWORD                 bIsDifferentPixelFormat;
  HRESULT               ddRVal;
  VOID                  *CanCreateSurface;
} *PDD_CANCREATESURFACEDATA, DD_CANCREATESURFACEDATA;

Anggota

lpDD

Menunjuk ke struktur DD_DIRECTDRAW_GLOBAL yang menjelaskan perangkat driver.

lpDDSurfaceDesc

Menunjuk ke struktur DDSURFACEDESC yang berisi deskripsi permukaan atau buffer yang akan dibuat. Lihat bagian Keterangan untuk informasi tambahan tentang anggota ini.

bIsDifferentPixelFormat

Menunjukkan apakah format piksel permukaan yang akan dibuat berbeda dari permukaan utama. Untuk panggilan balik CanCreateD3DBuffer D3DBuffer, anggota ini selalu diatur ke FALSE karena driver mencoba membuat buffer yang berisi data atau perintah vertex, bukan data piksel.

ddRVal

Menentukan lokasi di mana driver menulis nilai pengembalian dari panggilan balik DdCanCreateSurface atau CanCreateD3DBuffer . Kode pengembalian DD_OK menunjukkan keberhasilan. Untuk informasi selengkapnya, lihat Mengembalikan Nilai untuk DirectDraw.

CanCreateSurface

Digunakan oleh MICROSOFT DirectDraw API dan tidak boleh diisi oleh driver.

Keterangan

Deskripsi permukaan DirectDraw yang ditunjukkan oleh anggota lpDDSurfaceDesc sebenarnya adalah struktur DDSURFACEDESC2 (bukan struktur DDSURFACEDESC) untuk DirectDraw 6.0 dan runtime yang lebih baru. Oleh karena itu, jika Anda membutuhkan informasi pada waktu pembuatan permukaan dari anggota yang berada dalam struktur DDSURFACEDESC2 tetapi tidak dalam struktur DDSURFACEDESC, Anda cukup melemparkan pointer ke struktur DDSURFACEDESC ke penunjuk ke struktur DDSURFACEDESC2 sebelum digunakan. Contoh berikut menunjukkan bagaimana nilai dwTextureStage (anggota struktur DDSURFACEDESC2, tetapi tidak juga struktur DDSURFACEDESC) dapat diperoleh dari pointer ke struktur DDSURFACEDESC.

DDSURFACEDESC2* pddsd = (DDSURFACEDESC2*)pccsd->lpDDSurfaceDesc;
DWORD dwStage = pddsd->dwTextureStage;

Persyaratan

Persyaratan Nilai
Header ddrawint.h (termasuk Winddi.h)

Lihat juga

CanCreateD3DBuffer

DdCanCreateSurface