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

  • Article

Crée un instance IWICBitmapFrameEncode.

Syntaxe

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

Paramètres

[out] ppIFrameEncode

Type : IWICBitmapFrameEncode**

Pointeur qui reçoit un pointeur vers le nouveau instance d’un IWICBitmapFrameEncode.

[in, out] ppIEncoderOptions

Type : IPropertyBag2**

facultatif. Reçoit les propriétés nommées à utiliser pour l’initialisation de trame suivante. Consultez la section Notes.

Valeur de retour

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le paramètre ppIEncoderOptions peut être utilisé pour recevoir un IPropertyBag2 qui peut ensuite être utilisé pour spécifier des options d’encodeur. Pour ce faire, passez un pointeur vers un pointeur IPropertyBag2 NULL dans ppIEncoderOptions. Le IPropertyBag2 retourné est initialisé avec toutes les options d’encodeur disponibles pour le format donné, à leurs valeurs par défaut. Pour spécifier un comportement d’encodage autre que celui par défaut, définissez les options d’encodeur nécessaires sur le IPropertyBag2 et passez-les à IWICBitmapFrameEncode ::Initialize.

Note Ne passez pas de pointeur vers un IPropertyBag2 initialisé. Le pointeur sera remplacé et le IPropertyBag2 d’origine ne sera pas libéré.
 
Sinon, vous pouvez passer null dans ppIEncoderOptions si vous n’avez pas l’intention de spécifier les options d’encodeur.

Pour obtenir un exemple de définition des options d’encodeur, consultez Vue d’ensemble de l’encodage.

Pour les formats qui prennent en charge l’encodage de plusieurs images (par exemple, TIFF, JPEG-XR), vous ne pouvez travailler que sur une seule image à la fois. Cela signifie que vous devez appeler IWICBitmapFrameEncode ::Commit avant d’appeler à nouveau CreateNewFrame .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2, Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincodec.h
Bibliothèque Windowscodecs.lib
DLL Windowscodecs.dll

Voir aussi

Vue d’ensemble de l’encodage

IPropertyBag2

Iwicbitmapencoder