Méthode IWICBitmapFrameEncode ::SetPixelFormat (wincodec.h)

Demande que l’encodeur utilise le format de pixel spécifié.

Syntaxe

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

Paramètres

[in, out] pPixelFormat

Type : WICPixelFormatGUID*

En entrée, le GUID de format de pixel demandé. En sortie, le GUID de format de pixels le plus proche pris en charge par l’encodeur ; cela peut être différent du format demandé. Pour obtenir la liste des GUID de format de pixels, consultez Formats de pixels natifs.

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles sont les suivantes.

Code de retour Description
S_OK
Réussite.
WINCODEC_ERR_WRONGSTATE
La méthode IWICBitmapFrameEncode ::Initialize n’a pas été appelée.

Remarques

L’encodeur peut ne pas prendre en charge le format de pixel demandé. Si ce n’est pas le cas, SetPixelFormat retourne la correspondance la plus proche dans le bloc de mémoire vers lequel pPixelFormat pointe. Si le format de pixel retourné ne correspond pas au format demandé, vous devez utiliser un objet IWICFormatConverter pour convertir les données de pixel.

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

IWICBitmapFrameEncode

Formats de pixels natifs