DD_CREATESURFACEDATA結構 (ddrawint.h)

DD_CREATESURFACEDATA 結構包含建立介面所需的資訊--在 CreateD3DBuffer、命令或頂點緩衝區的情況下。

語法

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;

成員

lpDD

指向描述驅動程式裝置 的DD_DIRECTDRAW_GLOBAL 結構。

lpDDSurfaceDesc

指向描述驅動程式應該建立之介面或緩衝區的 DDSURFACEDESC 結構。

lplpSList

指向描述驅動程式所建立介面物件的 DD_SURFACE_LOCAL 結構清單。 在 Microsoft Windows 2000 和更新版本上，此陣列中通常只有一個專案。 不過，如果驅動程式支援使用 DdGetDriverInfo 搭配GUID_NTPrivateDriverCaps的 Windows 98/Me 樣式介面建立技術，而且驅動程式會設定DDHAL_PRIVATECAP_ATOMICSURFACECREATION旗標，則成員會包含一份介面清單， (通常有多個) 。

dwSCnt

指定 lplpSList 指向之清單中的表面數目。 此值通常是 Windows 2000 和更新版本上的 1。 不過，如果驅動程式支援使用 DdGetDriverInfo 搭配GUID_NTPrivateDriverCaps的 Windows 98/Me 樣式表面建立技術，則成員會包含清單中的實際表面數目， (通常有多個) 。

ddRVal

指定驅動程式寫入 DdCreateSurface 或 CreateD3DBuffer 回呼之傳回值的位置。 DD_OK的傳回碼表示成功。 如需詳細資訊，請參閱 DirectDraw 的傳回值。

CreateSurface

由 Microsoft DirectDraw API 使用，且不應由驅動程式填入。

規格需求

另請參閱

CreateD3DBuffer

DdCreateSurface

DdGetDriverInfo