Compartilhar via


Método IWICImagingFactory::CreateEncoder (wincodec.h)

Cria uma nova instância da classe IWICBitmapEncoder .

Sintaxe

HRESULT CreateEncoder(
  [in]           REFGUID           guidContainerFormat,
  [in, optional] const GUID        *pguidVendor,
  [out, retval]  IWICBitmapEncoder **ppIEncoder
);

Parâmetros

[in] guidContainerFormat

Tipo: REFGUID

O GUID para o formato de contêiner desejado.

Valor Significado
GUID_ContainerFormatBmp
O GUID de formato de contêiner BMP.
GUID_ContainerFormatPng
O GUID de formato de contêiner PNG.
GUID_ContainerFormatIco
O GUID de formato de contêiner de ICO.
GUID_ContainerFormatJpeg
O GUID de formato de contêiner JPEG.
GUID_ContainerFormatTiff
O GUID de formato de contêiner TIFF.
GUID_ContainerFormatGif
O GUID de formato de contêiner GIF.
GUID_ContainerFormatWmp
O GUID de formato de contêiner do HD Photo.

[in, optional] pguidVendor

Tipo: const GUID*

O GUID para o fornecedor de codificador preferencial.

Valor Significado
NULO
Nenhum fornecedor de codec preferencial.
GUID_VendorMicrosoft
Prefira usar o codificador da Microsoft.
GUID_VendorMicrosoftBuiltIn
Prefira usar o codificador nativo da Microsoft.

[out, retval] ppIEncoder

Tipo: IWICBitmapEncoder**

Um ponteiro que recebe um ponteiro para um novo IWICBitmapEncoder.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Outros valores podem estar disponíveis para guidContainerFormat e pguidVendor , dependendo dos codificadores habilitados para WIC instalados. Os valores listados são aqueles que têm suporte nativo pelo sistema operacional.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincodec.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll

Confira também

IWICImagingFactory

GUIDs e CLSIDs do WIC