DD_SYNCSURFACEDATA-Struktur (ddrawint.h)

Die DD_SYNCSURFACEDATA-Struktur enthält die Oberflächeninformationen.

Syntax

typedef struct _DD_SYNCSURFACEDATA {
  PDD_DIRECTDRAW_LOCAL lpDD;
  PDD_SURFACE_LOCAL    lpDDSurface;
  DWORD                dwSurfaceOffset;
  ULONG_PTR            fpLockPtr;
  LONG                 lPitch;
  DWORD                dwOverlayOffset;
  ULONG                dwDriverReserved1;
  ULONG                dwDriverReserved2;
  ULONG                dwDriverReserved3;
  ULONG                dwDriverReserved4;
  HRESULT              ddRVal;
} *PDD_SYNCSURFACEDATA, DD_SYNCSURFACEDATA;

Member

lpDD

Verweist auf eine DD_DIRECTDRAW_LOCAL Struktur, die nur für den aktuellen Microsoft DirectDraw-Prozess relevant ist.

lpDDSurface

Verweist auf die DD_SURFACE_LOCAL Struktur, die die Oberfläche beschreibt, mit der synchronisiert werden soll.

dwSurfaceOffset

Enthält den Byteoffset vom Anfang des Framepuffers bis zum Anfang der Oberfläche. Dieser Wert wird nur vom Video-Miniporttreiber verwendet. Dieser Member muss Daten enthalten, die vom Treiber ausgefüllt werden.

fpLockPtr

Enthält den Zeigerwert, der vom DdLock-Aufruf für den Zugriff auf die Oberfläche zurückgegeben werden soll. Dieser Wert wird von einem Kernelmodusclient verwendet. Dieser Member kann vom Treiber geändert werden, muss aber nicht sein.

lPitch

Enthält den Pitch in Bytes, der während eines DdLock-Aufrufs an den Client übergeben wird. Dieser Member kann vom Treiber geändert werden, muss aber nicht sein.

dwOverlayOffset

Enthält den Byteoffset vom Anfang des Framepuffers bis zum Anfang der Überlagerung. Dieser Wert wird nur vom Video-Miniporttreiber verwendet und kann sich vom dwSurfaceOffset-Element unterscheiden, wenn das Zuschneiden beteiligt ist oder wenn der Overlayursprung nicht oben links auf der Oberfläche liegt. Dieser Member muss Daten enthalten, die vom Treiber ausgefüllt werden.

dwDriverReserved1

Reserviert für die Verwendung durch den Anzeigetreiber.

dwDriverReserved2

Reserviert für die Verwendung durch den Anzeigetreiber.

dwDriverReserved3

Reserviert für die Verwendung durch den Anzeigetreiber.

dwDriverReserved4

Reserviert für die Verwendung durch den Anzeigetreiber. Nur Windows 2000 und höher.

ddRVal

Gibt den Speicherort an, an dem der Treiber den Rückgabewert des DdSyncSurfaceData-Rückrufs schreibt. Ein Rückgabecode von DD_OK gibt den Erfolg an. Weitere Informationen finden Sie unter Rückgabewerte für DirectDraw.

Anforderungen

Anforderung	Wert
Header	ddrawint.h (einschließlich Winddi.h)

Weitere Informationen

DdLock

DdSyncSurfaceData