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

Vedi anche

IDirectDrawSurface7