Share via

Proporcionar una interfaz de usuario

  • Artículo

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Los complementos DSP pueden proporcionar una página de propiedades para crear una interfaz de usuario. Para ello, el complemento debe incluir un objeto de página de propiedades que proporcione una implementación de una interfaz IPropertyPage . El objeto de complemento DSP debe implementar ISpecifyPropertyPages::GetPages, que permite que Reproductor multimedia de Windows busque e identifique la página de propiedades correcta para el complemento.

Mostrar un gráfico de estado

Los complementos DSP pueden mostrar un gráfico pequeño o una serie de gráficos, en el área de estado Reproductor multimedia de Windows para notificar al usuario que un complemento está activo. Para admitir esta característica, el complemento debe implementar la interfaz IPropertyBag . Reproductor multimedia de Windows llama a IPropertyBag::Read, proporcionando un puntero al nombre de propiedad solicitado "IconStreams", que distingue mayúsculas de minúsculas y un puntero a una estructura VARIANT que recibe los datos del gráfico. El complemento crea un objeto IStream (o SAFEARRAY de objetos IStream si hay varios gráficos), carga los datos gráficos, incluida la información de encabezado, en la secuencia y, a continuación, devuelve un puntero al objeto IStream mediante el miembro punkVal de la estructura VARIANT . Si el complemento proporciona solo un gráfico, especifica el miembro vt de la estructura VARIANT como VT_UNKNOWN. Si el complemento proporciona varios objetos IStream gráficos mediante SAFEARRAY, especifica el miembro vt de la estructura VARIANT como VT_ARRAY.

Los gráficos se pueden almacenar en una variedad de formatos de archivo, entre los que se incluyen:

BMP

Las imágenes de mapa de bits de Microsoft Windows no están comprimidas.

JPEG

Formato de imagen comprimido que se usa habitualmente para páginas web. Los archivos de formato JPEG suelen tener extensiones de nombre de archivo .jpg.

GIF

Formato de imagen comprimido que se usa habitualmente para páginas web.

PNG

Formato de imagen comprimido que se usa habitualmente para páginas web.

Las dimensiones máximas de los gráficos del complemento DSP son de 38 píxeles de ancho y 14 píxeles de alto.

La secuencia de bytes IStream que contiene el gráfico de estado debe incluir información de encabezado. Sin información de encabezado, Reproductor multimedia de Windows no puede identificar correctamente el tipo de gráfico y, por lo tanto, no cargará la imagen.

Introducción al desarrollador del complemento DSP