Metodo IWICImageEncoder::WriteThumbnail (wincodec.h)

Codifica l'immagine specificata come anteprima nel codificatore bitmap WIC specificato.

Sintassi

HRESULT WriteThumbnail(
  [in] ID2D1Image               *pImage,
  [in] IWICBitmapEncoder        *pEncoder,
  [in] const WICImageParameters *pImageParameters
);

Parametri

[in] pImage

Tipo: ID2D1Image*

Immagine Direct2D che verrà codificata.

[in] pEncoder

Tipo: IWICBitmapEncoder*

Codificatore in cui è impostata l'anteprima.

[in] pImageParameters

Tipo: const WICImageParameters*

Parametri aggiuntivi per controllare la codifica.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È necessario creare l'immagine passata sullo stesso dispositivo di IWICImagingFactory2::CreateImageEncoder. Se non si specificano parametri aggiuntivi nella variabile a cui punta pImageParameters , il codificatore usa un set di valori predefiniti utili. Per informazioni su queste impostazioni predefinite, vedi WICImageParameters.

Prima di chiamare WriteThumbnail, è necessario configurare l'interfaccia IWICBitmapEncoder per il codificatore in cui si vuole impostare l'anteprima.

Se WriteThumbnail ha esito negativo, potrebbe restituire E_OUTOFMEMORY, D2DERR_WRONG_RESOURCE_DOMAIN o altri codici di errore dal codificatore.

Requisiti

Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll

Vedi anche

IWICImageEncoder

IWICImagingFactory2::CreateImageEncoder

WICImageParameters