IThumbnailProvider：：GetThumbnail 方法 (thumbcache.h)

获取缩略图和 alpha 类型。

语法

HRESULT GetThumbnail(
  [in]  UINT          cx,
  [out] HBITMAP       *phbmp,
  [out] WTS_ALPHATYPE *pdwAlpha
);

[in] cx

类型： UINT

最大缩略图大小（以像素为单位）。 Shell 以此大小或更小大小绘制返回的位图。返回的位图应适合宽度和高度 的平方 cx，尽管它不需要是方形图像。 Shell 缩放位图以较小的大小呈现。例如，如果图像的纵横比为 6：4，则返回的位图也应具有 6：4 纵横比。

[out] phbmp

类型： HBITMAP*

此方法返回时，包含指向缩略图句柄的指针。图像必须是 DIB 部分，每个像素 32 位。如果位图的宽度或高度大于 cx 指定的大小，Shell 会向下缩放位图。 Shell 始终遵循纵横比，并且从不缩放大于其原始大小的位图。

[out] pdwAlpha

类型： WTS_ALPHATYPE*

此方法返回时，包含指向WTS_ALPHATYPE枚举中的以下值之一的指针：

0x0。位图是未知格式。尽管如此，Shell 仍会尝试检测图像是否具有 alpha 通道。

0x1。位图是不含 alpha 的 RGB 图像。 alpha 通道无效，Shell 会将其忽略。

0x2。位图是具有有效 alpha 通道的 ARGB 图像。

类型： HRESULT

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