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: La indicación visual se muestra cuando se genera un sonido a través del altavoz interno del equipo.

Windows NT/2000: La indicación visual se muestra 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

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

dwFlags

Tipo: DWORD

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

Value 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

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:

Value 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 uso futuro. Debe establecerse en cero.

iFSTextEffectMSec

Tipo: DWORD

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 completa genera un sonido.

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

iFSTextEffectColorBits

Tipo: DWORD

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 de pantalla completa genera un sonido.

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

iFSGrafEffect

Tipo: DWORD

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:

Value Significado
SSGF_DISPLAY
3
 Parpadee toda la pantalla.
SSGF_NONE
0
 No hay señal visual.
 

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

iFSGrafEffectMSec

Tipo: DWORD

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 de pantalla completa genera un sonido.

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

iFSGrafEffectColor

Tipo: DWORD

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 de pantalla completa genera un sonido.

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

iWindowsEffect

Tipo: DWORD

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:

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

iWindowsEffectMSec

Tipo: DWORD

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 uso futuro. Debe establecerse en cero.

lpszWindowsEffectDLL

Tipo: LPTSTR

Este miembro se reserva para uso futuro. Debe establecerse en NULL.

iWindowsEffectOrdinal

Tipo: DWORD

Este miembro se reserva 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, dwFlags e 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado winuser.h (incluya Windows.h)

Consulte también

Estructuras de accesibilidad

SoundSentryProc

SystemParametersInfo