Metodo IWICBitmapCodecInfo::GetFileExtensions (wincodec.h)

Articolo
03/03/2024

Recupera un elenco delimitato da virgole delle estensioni di file associate al codec.

Sintassi

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

Parametri

[in] cchFileExtensions

Tipo: UINT

Dimensioni del buffer dell'estensione del nome file. Usare 0 alla prima chiamata per determinare le dimensioni del buffer necessarie.

[in, out] wzFileExtensions

Tipo: WCHAR*

Riceve un elenco delimitato da virgole di estensioni di file associate al codec. Usare NULL alla prima chiamata per determinare le dimensioni del buffer necessarie.

[in, out] pcchActual

Tipo: UINT*

Dimensioni effettive del buffer necessarie per recuperare tutte le estensioni di file associate al codec.

Valore restituito

Tipo: HRESULT

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

Commenti

L'estensione predefinita per un codificatore di immagini è il primo elemento nell'elenco delle estensioni restituite.

Il modello di utilizzo per questo metodo è un processo a due chiamate. La prima chiamata recupera le dimensioni del buffer necessarie per recuperare il numero di versione di gestione colori completo chiamandolo con cchFileExtensions impostato su 0 e wzFileExtensions impostato su NULL. Questa chiamata imposta pcchActual sulle dimensioni del buffer necessarie. Dopo aver determinato le dimensioni del buffer necessarie, una seconda chiamata GetFileExtensions con cchFileExtensions impostata sulle dimensioni del buffer e wzFileExtensions impostata su un buffer 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

Condividi tramite