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
| 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 |