Metode IWICBitmapCodecInfo::GetFileExtensions (wincodec.h)

Artikel
08/27/2023

Mengambil daftar ekstensi nama file yang dibatasi koma yang terkait dengan codec.

Sintaks

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

Parameter

[in] cchFileExtensions

Jenis: UINT

Ukuran buffer ekstensi nama file. Gunakan 0 pada panggilan pertama untuk menentukan ukuran buffer yang diperlukan.

[in, out] wzFileExtensions

Jenis: WCHAR*

Menerima daftar ekstensi nama file yang dibatasi koma yang terkait dengan codec. Gunakan NULL pada panggilan pertama untuk menentukan ukuran buffer yang diperlukan.

[in, out] pcchActual

Jenis: UINT*

Ukuran buffer aktual yang diperlukan untuk mengambil semua ekstensi nama file yang terkait dengan codec.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Ekstensi default untuk encoder gambar adalah item pertama dalam daftar ekstensi yang dikembalikan.

Pola penggunaan untuk metode ini adalah dua proses panggilan. Panggilan pertama mengambil ukuran buffer yang diperlukan untuk mengambil nomor versi manajemen warna penuh dengan memanggilnya dengan cchFileExtensions diatur ke 0 dan wzFileExtensions diatur ke NULL. Panggilan ini mengatur pcchActual ke ukuran buffer yang diperlukan. Setelah ukuran buffer yang diperlukan ditentukan, panggilan GetFileExtensions kedua dengan cchFileExtensions diatur ke ukuran buffer dan wzFileExtensions diatur ke buffer dengan ukuran yang sesuai akan mengambil format piksel.

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

Bagikan melalui