Metode IWICFormatConverterInfo::GetPixelFormats (wincodec.h)

Artikel
03/03/2024

Mengambil daftar GUID yang menandakan format piksel mana yang didukung konverter.

Sintaks

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

Parameter

[in] cFormats

Jenis: UINT

Ukuran array pPixelFormatGUIDs .

[in, out] pPixelFormatGUIDs

Jenis: WICPixelFormatGUID*

Penunjuk ke array GUID yang menerima format piksel yang didukung konverter.

[out] pcActual

Jenis: UINT*

Ukuran array aktual yang diperlukan untuk mengambil semua format piksel yang didukung oleh konverter.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Pengonversi format tidak selalu menjamin simetrisitas sehubungan dengan konversi; artinya, konverter mungkin dapat mengonversi DARI format tertentu tanpa benar-benar dapat mengonversi ke format tertentu. Untuk menguji simetrisitas, gunakan CanConvert.

Untuk menentukan jumlah format piksel yang dapat ditangani konverter, atur cFormats ke 0 dan pPixelFormatGUIDs ke NULL. Pengonversi akan mengisi pcActual dengan jumlah format yang didukung oleh konverter tersebut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincodec.h
Pustaka	Windowscodecs.lib
DLL	Windowscodecs.dll

Bagikan melalui