Metodo IDirectDrawSurface7::SetSurfaceDesc (ddraw.h)

Imposta le caratteristiche di una superficie esistente.

Sintassi

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

Parametri

[in] unnamedParam1

Puntatore a una struttura DDSURFACEDESC2 che contiene le nuove caratteristiche di superficie.

[in] unnamedParam2

Attualmente non usato e deve essere impostato su 0.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è DD_OK.

Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:

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

Commenti

Attualmente è possibile usare SetSurfaceDesc solo per impostare i dati di superficie e il formato pixel usati da una superficie di memoria di sistema esplicita. Ciò è utile perché consente a una superficie di usare i dati da un buffer allocato in precedenza senza copiare. La nuova memoria di superficie viene allocata dall'applicazione client e pertanto l'applicazione client deve anche deallocare.

L'oggetto DirectDrawSurface non dealloca la memoria della superficie non allocata. Pertanto, quando la memoria di superficie non è più necessaria, è necessario deallocare. Tuttavia, quando si chiama SetSurfaceDesc, DirectDraw libera la memoria della superficie originale allocata in modo implicito al momento della creazione della superficie.

Requisiti

Vedi anche

IDirectDrawSurface7