Método IThumbnailProvider::GetThumbnail (thumbcache.h)

Obtiene una imagen en miniatura y un tipo alfa.

Sintaxis

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

Parámetros

[in] cx

Tipo: UINT

Tamaño máximo de miniatura, en píxeles. Shell dibuja el mapa de bits devuelto en este tamaño o menor. El mapa de bits devuelto debe caber en un cuadrado de ancho y alto cx, aunque no es necesario que sea una imagen cuadrada. Shell escala el mapa de bits para representarlo en tamaños inferiores. Por ejemplo, si la imagen tiene una relación de aspecto de 6:4, el mapa de bits devuelto también debe tener una relación de aspecto de 6:4.

[out] phbmp

Tipo: HBITMAP*

Cuando este método vuelve, contiene un puntero al identificador de imagen en miniatura. La imagen debe ser una sección DIB y 32 bits por píxel. Shell reduce verticalmente el mapa de bits si su ancho o alto es mayor que el tamaño especificado por cx. Shell siempre respeta la relación de aspecto y nunca escala un mapa de bits mayor que su tamaño original.

[out] pdwAlpha

Tipo: WTS_ALPHATYPE*

Cuando este método finaliza, contiene un puntero a uno de los siguientes valores de la enumeración WTS_ALPHATYPE:

WTSAT_UNKNOWN (0x0)

0x0. El mapa de bits es un formato desconocido. El Shell intenta, sin embargo, detectar si la imagen tiene un canal alfa.

WTSAT_RGB (0x1)

0x1. El mapa de bits es una imagen RGB sin alfa. El canal alfa no es válido y shell lo omite.

WTSAT_ARGB (0x2)

0x2. El mapa de bits es una imagen ARGB con un canal alfa válido.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	thumbcache.h