Estructura SOUNDSENTRYA (winuser.h)
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:
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:
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 |
|---|---|
|
Parpadee toda la pantalla. |
|
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:
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) |