Méthode IWICBitmapEncoder ::CreateNewFrame (wincodec.h)
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.
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 |