Compartilhar via


estrutura DD_CREATESURFACEDATA (ddrawint.h)

A estrutura DD_CREATESURFACEDATA contém informações necessárias para criar uma superfície, no caso de CreateD3DBuffer, um buffer de comando ou vértice.

Sintaxe

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;

Membros

lpDD

Aponta para a estrutura DD_DIRECTDRAW_GLOBAL que descreve o dispositivo do driver.

lpDDSurfaceDesc

Aponta para a estrutura DDSURFACEDESC que descreve a superfície ou o buffer que o driver deve criar.

lplpSList

Aponta para uma lista de estruturas de DD_SURFACE_LOCAL que descrevem os objetos de superfície criados pelo driver. No Microsoft Windows 2000 e posterior, geralmente há apenas uma entrada nessa matriz. No entanto, se o driver der suporte às técnicas de criação de superfície estilo Windows 98/Me usando DdGetDriverInfo com GUID_NTPrivateDriverCaps e o driver definir o sinalizador DDHAL_PRIVATECAP_ATOMICSURFACECREATION, o membro conterá uma lista de superfícies (geralmente mais de uma).

dwSCnt

Especifica o número de superfícies na lista à qual lplpSList aponta. Esse valor geralmente é 1 no Windows 2000 e posterior. No entanto, se o driver der suporte às técnicas de criação de superfície estilo Windows 98/Me usando DdGetDriverInfo com GUID_NTPrivateDriverCaps, o membro conterá o número real de superfícies na lista (geralmente mais de uma).

ddRVal

Especifica o local no qual o driver grava o valor retornado do retorno de chamada DdCreateSurface ou CreateD3DBuffer . Um código de retorno de DD_OK indica êxito. Para obter mais informações, consulte Valores retornados para DirectDraw.

CreateSurface

Usado pela API do Microsoft DirectDraw e não deve ser preenchido pelo driver.

Requisitos

Requisito Valor
Cabeçalho ddrawint.h (inclua Winddi.h)

Confira também

CreateD3DBuffer

DdCreateSurface

DdGetDriverInfo