struktur DD_CREATESURFACEDATA (ddrawint.h)

Artikel
03/09/2023

Struktur DD_CREATESURFACEDATA berisi informasi yang diperlukan untuk membuat surface--dalam kasus CreateD3DBuffer, perintah atau buffer vertex.

Sintaks

typedef struct _DD_CREATESURFACEDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACEDESC       lpDDSurfaceDesc;
  PDD_SURFACE_LOCAL     *lplpSList;
  DWORD                 dwSCnt;
  HRESULT               ddRVal;
  VOID                  *CreateSurface;
} *PDD_CREATESURFACEDATA, DD_CREATESURFACEDATA;

Anggota

lpDD

Menunjuk ke struktur DD_DIRECTDRAW_GLOBAL yang menjelaskan perangkat driver.

lpDDSurfaceDesc

Menunjuk ke struktur DDSURFACEDESC yang menjelaskan permukaan atau buffer yang harus dibuat driver.

lplpSList

Menunjuk ke daftar struktur DD_SURFACE_LOCAL yang menjelaskan objek permukaan yang dibuat oleh driver. Pada Microsoft Windows 2000 dan yang lebih baru, biasanya hanya ada satu entri dalam array ini. Namun, jika driver mendukung teknik pembuatan permukaan gaya Windows 98/Me menggunakan DdGetDriverInfo dengan GUID_NTPrivateDriverCaps, dan driver mengatur bendera DDHAL_PRIVATECAP_ATOMICSURFACECREATION, anggota berisi daftar permukaan (biasanya lebih dari satu).

dwSCnt

Menentukan jumlah permukaan dalam daftar tempat lplpSList menunjuk. Nilai ini biasanya 1 pada Windows 2000 dan yang lebih baru. Namun, jika driver mendukung teknik pembuatan permukaan gaya Windows 98/Me menggunakan DdGetDriverInfo dengan GUID_NTPrivateDriverCaps, anggota berisi jumlah permukaan aktual dalam daftar (biasanya lebih dari satu).

ddRVal

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

CreateSurface

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