IDirectDrawSurface7::SetSurfaceDesc-Methode (ddraw.h)

Legt die Merkmale einer vorhandenen Oberfläche fest.

Syntax

HRESULT SetSurfaceDesc(
  [in] LPDDSURFACEDESC2 unnamedParam1,
  [in] DWORD            unnamedParam2
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine DDSURFACEDESC2 Struktur, die die neuen Oberflächeneigenschaften enthält.

[in] unnamedParam2

Derzeit nicht verwendet und muss auf 0 festgelegt werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, kann die -Methode einen der folgenden Fehlerwerte zurückgeben:

• DDERR_INVALIDPARAMS
• DDERR_INVALIDOBJECT
• DDERR_SURFACELOST
• DDERR_SURFACEBUSY
• DDERR_INVALIDSURFACETYPE
• DDERR_INVALIDPIXELFORMAT
• DDERR_INVALIDCAPS
• DDERR_UNSUPPORTED
• DDERR_GENERIC

Hinweise

Derzeit können Sie SetSurfaceDesc nur verwenden, um die Oberflächendaten und das Pixelformat festzulegen, die von einer expliziten Systemspeicheroberfläche verwendet werden. Dies ist nützlich, da eine Oberfläche daten aus einem zuvor zugeordneten Puffer ohne Kopieren verwenden kann. Der neue Surface-Arbeitsspeicher wird von der Clientanwendung zugewiesen, und daher muss die Clientanwendung auch die Zuordnung aufheben.

Das DirectDrawSurface-Objekt gibt die Zuordnung von Oberflächenspeicher, den es nicht zugewiesen hat, nicht auf. Wenn der Oberflächenspeicher nicht mehr benötigt wird, müssen Sie die Zuordnung aufheben. Wenn Sie jedoch SetSurfaceDesc aufrufen, gibt DirectDraw den ursprünglichen Oberflächenspeicher frei, den es beim Erstellen der Oberfläche implizit zugewiesen hat.

Anforderungen

Weitere Informationen

IDirectDrawSurface7