structure DD_CREATESURFACEDATA (ddrawint.h)

Article
02/28/2024

La structure DD_CREATESURFACEDATA contient les informations nécessaires à la création d’une surface, dans le cas de CreateD3DBuffer, une commande ou une mémoire tampon de vertex.

Syntaxe

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;

Membres

lpDD

Pointe vers la structure DD_DIRECTDRAW_GLOBAL qui décrit l’appareil du pilote.

lpDDSurfaceDesc

Pointe vers la structure DDSURFACEDESC décrivant la surface ou la mémoire tampon que le pilote doit créer.

lplpSList

Pointe vers une liste de structures DD_SURFACE_LOCAL décrivant les objets surface créés par le pilote. Sur Microsoft Windows 2000 et versions ultérieures, il n’existe généralement qu’une seule entrée dans ce tableau. Toutefois, si le pilote prend en charge les techniques de création de surface de style Windows 98/Me à l’aide de DdGetDriverInfo avec GUID_NTPrivateDriverCaps, et que le pilote définit l’indicateur DDHAL_PRIVATECAP_ATOMICSURFACECREATION, le membre contient une liste de surfaces (généralement plusieurs).

dwSCnt

Spécifie le nombre de surfaces de la liste sur lesquelles lplpSList pointe. Cette valeur est généralement 1 sur Windows 2000 et versions ultérieures. Toutefois, si le pilote prend en charge les techniques de création de surface de style Windows 98/Me à l’aide de DdGetDriverInfo avec GUID_NTPrivateDriverCaps, le membre contient le nombre réel de surfaces dans la liste (généralement plusieurs).

ddRVal

Spécifie l’emplacement dans lequel le pilote écrit la valeur de retour du rappel DdCreateSurface ou CreateD3DBuffer . Un code de retour de DD_OK indique la réussite. Pour plus d’informations, consultez Valeurs de retour pour DirectDraw.

CreateSurface

Utilisé par l’API Microsoft DirectDraw et ne doit pas être renseigné par le pilote.