Compartir a través de

Estructura SOUNDSENTRYA (winuser.h)

  • Artículo

Contiene información sobre la característica de accesibilidad SoundSentry. Cuando la característica SoundSentry está activada, el equipo muestra una indicación visual solo cuando se genera un sonido.

Windows 95/98: Se muestra la indicación visual cuando se genera un sonido a través del altavoz interno del equipo.

Windows NT/2000: Se muestra la indicación visual cuando se genera un sonido a través de los servicios de sonido multimedia o a través del altavoz del equipo.

Sintaxis

typedef struct tagSOUNDSENTRYA {
  UINT  cbSize;
  DWORD dwFlags;
  DWORD iFSTextEffect;
  DWORD iFSTextEffectMSec;
  DWORD iFSTextEffectColorBits;
  DWORD iFSGrafEffect;
  DWORD iFSGrafEffectMSec;
  DWORD iFSGrafEffectColor;
  DWORD iWindowsEffect;
  DWORD iWindowsEffectMSec;
  LPSTR lpszWindowsEffectDLL;
  DWORD iWindowsEffectOrdinal;
} SOUNDSENTRYA, *LPSOUNDSENTRYA;

Miembros

cbSize

Tipo: UINT de

Especifica el tamaño, en bytes, de esta estructura.

dwFlags

Tipo: DWORD de

Conjunto de marcas de bits que especifican las propiedades de la característica SoundSentry. Se definen los siguientes valores de marca de bits:

Valor Significado
SSF_AVAILABLE
0x00000002
 Si se establece esta marca, la característica SoundSentry está disponible.
SSF_INDICATOR
0x00000004
 Esta marca no está implementada.
SSF_SOUNDSENTRYON
0x00000001
 Si se establece esta marca, la característica SoundSentry está activada.

iFSTextEffect

Tipo: DWORD de

Windows 95/98: Especifica la señal visual que se va a presentar cuando una aplicación en modo de texto genera un sonido mientras se ejecuta en una máquina virtual de pantalla completa. Este miembro puede ser uno de los siguientes valores:

Valor Significado
SSTF_BORDER
2
 Parpadee el borde de la pantalla (es decir, el área de análisis excesivo), que no está disponible en algunas pantallas.
SSTF_CHARS
1
 Caracteres flash en la esquina de la pantalla.
SSTF_DISPLAY
3
 Parpadee toda la pantalla.
SSTF_NONE
0
 Sin señal visual
 

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

iFSTextEffectMSec

Tipo: DWORD de

Windows 95/98: Especifica la duración, en milisegundos, de la señal visual que se muestra cuando una aplicación en modo de texto y pantalla completa genera un sonido.

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

iFSTextEffectColorBits

Tipo: DWORD de

Windows 95/98: Especifica el valor RGB del color que se va a usar al mostrar la señal visual que se muestra cuando una aplicación en modo de texto y pantalla completa genera un sonido.

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

iFSGrafEffect

Tipo: DWORD de

Windows 95/98: Especifica la señal visual que se va a presentar cuando una aplicación en modo gráfico genera un sonido mientras se ejecuta en una máquina virtual de pantalla completa. Este miembro puede ser uno de los siguientes valores:

Valor Significado
SSGF_DISPLAY
3
 Parpadee toda la pantalla.
SSGF_NONE
0
 Sin señal visual.
 

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

iFSGrafEffectMSec

Tipo: DWORD de

Windows 95/98: Especifica la duración, en milisegundos, de la señal visual que se muestra cuando una aplicación en modo gráfico y de pantalla completa genera un sonido.

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

iFSGrafEffectColor

Tipo: DWORD de

Windows 95/98: Especifica el valor RGB del color que se va a usar al mostrar la señal visual que se muestra cuando una aplicación en modo gráfico y de pantalla completa genera un sonido.

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

iWindowsEffect

Tipo: DWORD de

Especifica la señal visual que se va a mostrar cuando una aplicación basada en Windows genera un sonido o una aplicación MS-DOS que se ejecuta en una ventana. Este miembro puede ser uno de los siguientes valores:

Valor Significado
SSWF_CUSTOM
4
 Use una señal visual personalizada.
SSWF_DISPLAY
3
 Parpadee toda la pantalla.
SSWF_NONE
0
 Sin señal visual.
SSWF_TITLE
1
 Parpadee la barra de título de la ventana activa.
SSWF_WINDOW
2
 Parpadee la ventana activa.

iWindowsEffectMSec

Tipo: DWORD de

Windows 95/98: Especifica la duración, en milisegundos, de la señal visual que se muestra cuando una aplicación basada en Win32 (o una aplicación que se ejecuta en una ventana) genera un sonido.

Windows NT/2000: Este miembro está reservado para su uso futuro. Debe establecerse en cero.

lpszWindowsEffectDLL

Tipo: LPTSTR de

Este miembro está reservado para uso futuro. Debe establecerse en NULL.

iWindowsEffectOrdinal

Tipo: DWORD de

Este miembro está reservado para uso futuro. Debe establecerse en cero.

Observaciones

Una aplicación usa una estructura SOUNDSENTRY al llamar a la función SystemParametersInfo con el parámetro uiAction establecido en SPI_GETSOUNDSENTRY o SPI_SETSOUNDSENTRY. Al usar SPI_GETSOUNDSENTRY, una aplicación debe especificar el miembro cbSize de la estructura SOUNDSENTRY; La función SystemParametersInfo rellena los miembros restantes. Una aplicación debe especificar los miembros cbSize, dwFlagsy iWindowsEffect al usar el valor de SPI_SETSOUNDSENTRY.

Nota

El encabezado winuser.h define SOUNDSENTRY como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de winuser.h (incluya Windows.h)

Consulte también

estructuras de accesibilidad de

SoundSentryProc

SystemParametersInfo