struttura DD_CREATESURFACEDATA (ddrawint.h)

La struttura DD_CREATESURFACEDATA contiene informazioni necessarie per creare una superficie nel caso di CreateD3DBuffer, un comando o un buffer dei vertici.

Sintassi

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;

Members

lpDD

Punta alla struttura DD_DIRECTDRAW_GLOBAL che descrive il dispositivo del driver.

lpDDSurfaceDesc

Punta alla struttura DDSURFACEDESC che descrive la superficie o il buffer che il driver deve creare.

lplpSList

Punta a un elenco di DD_SURFACE_LOCAL strutture che descrivono gli oggetti superficie creati dal driver. In Microsoft Windows 2000 e versioni successive è in genere presente una sola voce in questa matrice. Tuttavia, se il driver supporta le tecniche di creazione della superficie di windows 98/Me usando DdGetDriverInfo con GUID_NTPrivateDriverCaps e il driver imposta il flag di DDHAL_PRIVATECAP_ATOMICSURFACECREATION, il membro contiene un elenco di superfici (in genere più di una).

dwSCnt

Specifica il numero di superfici nell'elenco a cui punta lplpSList . Questo valore è in genere 1 in Windows 2000 e versioni successive. Tuttavia, se il driver supporta le tecniche di creazione della superficie di windows 98/Me usando DdGetDriverInfo con GUID_NTPrivateDriverCaps, il membro contiene il numero effettivo di superfici nell'elenco (in genere più di uno).

ddRVal

Specifica il percorso in cui il driver scrive il valore restituito del callback DdCreateSurface o CreateD3DBuffer . Un codice restituito di DD_OK indica l'esito positivo. Per altre informazioni, vedere Valori restituiti per DirectDraw.

CreateSurface

Usato dall'API Microsoft DirectDraw e non deve essere compilato dal driver.

Requisiti

Vedi anche

CreateD3DBuffer

DdCreateSurface

DdGetDriverInfo