structure DD_CREATESURFACEDATA (ddrawint.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ddrawint.h (inclure Winddi.h) |