Compartilhar via


Método IWICBitmapEncoder::CreateNewFrame (wincodec.h)

Cria uma nova instância IWICBitmapFrameEncode .

Sintaxe

HRESULT CreateNewFrame(
  [out]     IWICBitmapFrameEncode **ppIFrameEncode,
  [in, out] IPropertyBag2         **ppIEncoderOptions
);

Parâmetros

[out] ppIFrameEncode

Tipo: IWICBitmapFrameEncode**

Um ponteiro que recebe um ponteiro para a nova instância de um IWICBitmapFrameEncode.

[in, out] ppIEncoderOptions

Tipo: IPropertyBag2**

Opcional. Recebe as propriedades nomeadas a serem usadas para inicialização de quadro subsequente. Consulte Observações.

Valor retornado

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

O parâmetro ppIEncoderOptions pode ser usado para receber um IPropertyBag2 que pode ser usado para especificar opções de codificador. Isso é feito passando um ponteiro para um ponteiro NULL IPropertyBag2 em ppIEncoderOptions. O IPropertyBag2 retornado é inicializado com todas as opções de codificador disponíveis para o formato determinado, com seus valores padrão. Para especificar o comportamento de codificação não padrão, defina as opções de codificador necessárias no IPropertyBag2 e passe-o para IWICBitmapFrameEncode::Initialize.

Nota Não passe um ponteiro para um IPropertyBag2 inicializado. O ponteiro será substituído e o IPropertyBag2 original não será liberado.
 
Caso contrário, você poderá passar NULL em ppIEncoderOptions se não pretende especificar opções de codificador.

Consulte Visão geral da codificação para obter um exemplo de como definir opções de codificador.

Para formatos que dão suporte à codificação de vários quadros (por exemplo, TIFF, JPEG-XR), você pode trabalhar em apenas um quadro por vez. Isso significa que você deve chamar IWICBitmapFrameEncode::Commit antes de chamar CreateNewFrame novamente.

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

Visão geral da codificação

IPropertyBag2

IWICBitmapEncoder