Metodo IDirectDrawSurface7::SetPalette (ddraw.h)
Collega un oggetto tavolozza a (o scollega uno da) una superficie. La superficie usa questa tavolozza per tutte le operazioni successive. La modifica della tavolozza avviene immediatamente, senza considerare la tempistica di aggiornamento.
Sintassi
HRESULT SetPalette(
[in] LPDIRECTDRAWPALETTE unnamedParam1
);
Parametri
[in] unnamedParam1
Puntatore all'interfaccia IDirectDrawPalette per l'oggetto tavolozza da usare con questa superficie. Se NULL, la tavolozza corrente viene scollegata.
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_GENERIC
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDPIXELFORMAT
- DDERR_INVALIDSURFACETYPE
- DDERR_NOEXCLUSIVEMODE
- DDERR_NOPALETTEATTACHED
- DDERR_NOPALETTEHW
- DDERR_NOT8BITCOLOR
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
Commenti
Quando si chiama SetPalette per impostare una tavolozza su una superficie per la prima volta, SetPalette incrementa il numero di riferimenti della tavolozza; le chiamate successive a SetPalette non influiscono sul conteggio dei riferimenti della tavolozza. Se si passa NULL come parametro lpDDPalette , la tavolozza viene rimossa dall'area e il conteggio dei riferimenti della tavolozza viene decrementato. Se non si elimina la tavolozza, la superficie rilascia automaticamente il riferimento alla tavolozza quando viene rilasciata la superficie stessa. In base alle regole COM, l'applicazione deve rilasciare tutti i riferimenti che contiene alla tavolozza quando l'oggetto non è più necessario.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |