Condividi tramite


Metodo IWICBitmapFrameEncode::SetPixelFormat (wincodec.h)

Richiede che il codificatore usi il formato pixel specificato.

Sintassi

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

Parametri

[in, out] pPixelFormat

Tipo: WICPixelFormatGUID*

In input, il GUID del formato pixel richiesto. Nell'output, il GUID del formato pixel più vicino supportato dal codificatore; può essere diverso dal formato richiesto. Per un elenco dei GUID in formato pixel, vedi Formati pixel nativi.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono quanto segue.

Codice restituito Descrizione
S_OK
Operazione completata.
WINCODEC_ERR_WRONGSTATE
Il metodo IWICBitmapFrameEncode::Initialize non è stato chiamato.

Commenti

Il codificatore potrebbe non supportare il formato pixel richiesto. In caso contrario, SetPixelFormat restituisce la corrispondenza più vicina nel blocco di memoria a cui punta pPixelFormat . Se il formato pixel restituito non corrisponde al formato richiesto, è necessario utilizzare un oggetto IWICFormatConverter per convertire i dati pixel.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2, Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincodec.h
Libreria Windowscodecs.lib
DLL Windowscodecs.dll

Vedi anche

IWICBitmapFrameEncode

Formati pixel nativi