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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |