DD_CREATESURFACEDATA-Struktur (ddrawint.h)
Die DD_CREATESURFACEDATA-Struktur enthält Informationen, die zum Erstellen einer Oberfläche erforderlich sind– im Fall von CreateD3DBuffer, einem Befehl oder einem Vertexpuffer.
Syntax
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;
Member
lpDD
Verweist auf die DD_DIRECTDRAW_GLOBAL-Struktur , die das Gerät des Treibers beschreibt.
lpDDSurfaceDesc
Verweist auf die DDSURFACEDESC-Struktur , die die Oberfläche oder den Puffer beschreibt, die der Treiber erstellen soll.
lplpSList
Verweist auf eine Liste mit DD_SURFACE_LOCAL Strukturen, die die vom Treiber erstellten Oberflächenobjekte beschreiben. Unter Microsoft Windows 2000 und höher gibt es in der Regel nur einen Eintrag in diesem Array. Wenn der Treiber jedoch die Oberflächenerstellungstechniken im Windows 98/Me-Stil mit DdGetDriverInfo mit GUID_NTPrivateDriverCaps unterstützt und der Treiber das flag DDHAL_PRIVATECAP_ATOMICSURFACECREATION festlegt, enthält der Member eine Liste von Oberflächen (in der Regel mehrere).
dwSCnt
Gibt die Anzahl der Oberflächen in der Liste an, auf die lplpSList verweist. Dieser Wert ist in Der Regel 1 unter Windows 2000 und höher. Wenn der Treiber jedoch die Oberflächenerstellungstechniken im Windows 98/Me-Stil mit DdGetDriverInfo mit GUID_NTPrivateDriverCaps unterstützt, enthält der Member die tatsächliche Anzahl von Oberflächen in der Liste (in der Regel mehr als eine).
ddRVal
Gibt den Speicherort an, an dem der Treiber den Rückgabewert des Rückrufs DdCreateSurface oder CreateD3DBuffer schreibt. Ein Rückgabecode von DD_OK gibt den Erfolg an. Weitere Informationen finden Sie unter Rückgabewerte für DirectDraw.
CreateSurface
Wird von der Microsoft DirectDraw-API verwendet und sollte nicht vom Treiber ausgefüllt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ddrawint.h (einschließlich Winddi.h) |