IWICBitmapCodecInfo::GetFileExtensions 方法 (wincodec.h)

检索与编解码器关联的文件扩展名的逗号分隔列表。

语法

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

参数

[in] cchFileExtensions

类型: UINT

文件扩展名缓冲区的大小。 首次调用时使用 0 以确定所需的缓冲区大小。

[in, out] wzFileExtensions

类型: WCHAR*

接收与编解码器关联的文件扩展名的逗号分隔列表。 首次调用时使用 NULL 以确定所需的缓冲区大小。

[in, out] pcchActual

类型: UINT*

检索与编解码器关联的所有文件扩展名所需的实际缓冲区大小。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

图像编码器的默认扩展是返回的扩展列表中的第一项。

此方法的使用模式是两个调用过程。 第一次调用通过将 cchFileExtensions 设置为 ,wzFileExtensionsNULL设置为 0 来检索检索全色管理版本号所需的缓冲区大小。 此调用将 pcchActual 设置为所需的缓冲区大小。 确定所需的缓冲区大小后,将 cchFileExtensions 设置为缓冲区大小且 wzFileExtensions 设置为适当大小的缓冲区的第二次 GetFileExtensions 调用将检索像素格式。

要求

要求
最低受支持的客户端 Windows XP SP2,Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib