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.

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

Confira também

Visão geral da codificação

IPropertyBag2

IWICBitmapEncoder