Metodo IWICBitmapCodecInfo::GetPixelFormats (wincodec.h)

Articolo
03/03/2024

Recupera i formati pixel supportati dal codec.

Sintassi

HRESULT GetPixelFormats(
  [in]      UINT cFormats,
  [in, out] GUID *pguidPixelFormats,
  [out]     UINT *pcActual
);

Parametri

[in] cFormats

Tipo: UINT

Dimensioni della matrice pguidPixelFormats . Usare 0 alla prima chiamata per determinare le dimensioni della matrice necessarie.

[in, out] pguidPixelFormats

Tipo: GUID*

Riceve i formati pixel supportati. Usare NULL alla prima chiamata per determinare le dimensioni della matrice necessarie.

[out] pcActual

Tipo: UINT*

Dimensioni della matrice necessarie per recuperare tutti i formati pixel supportati.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il modello di utilizzo per questo metodo è un processo a due chiamate. La prima chiamata recupera le dimensioni della matrice necessarie per recuperare tutti i formati pixel supportati chiamandola con cFormats impostato su 0 e pguidPixelFormats impostato su NULL. Questa chiamata imposta pcActual sulle dimensioni della matrice necessarie. Dopo aver determinato le dimensioni della matrice necessarie, una seconda chiamata GetPixelFormats con pguidPixelFormats impostata su una matrice delle dimensioni appropriate recupererà i formati 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

Condividi tramite