Structure SOUNDSENTRYA (winuser.h)
Contient des informations sur la fonctionnalité d’accessibilité SoundSentry. Lorsque la fonctionnalité SoundSentry est activée, l’ordinateur affiche une indication visuelle uniquement lorsqu’un son est généré.
Windows 95/98 : L’indication visuelle s’affiche lorsqu’un son est généré par le haut-parleur interne de l’ordinateur.
Windows NT/2000 : L’indication visuelle s’affiche lorsqu’un son est généré par le biais des services audio multimédias ou du haut-parleur de l’ordinateur.
Syntaxe
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;
Membres
cbSize
Type : UINT
Spécifie la taille, en octets, de cette structure.
dwFlags
Type : DWORD
Ensemble d’indicateurs de bits qui spécifient les propriétés de la fonctionnalité SoundSentry. Les valeurs d’indicateur de bits suivantes sont définies :
iFSTextEffect
Type : DWORD
Windows 95/98 : Spécifie le signal visuel à présenter lorsqu’une application en mode texte génère un son lors de l’exécution sur une machine virtuelle plein écran. Ce membre peut avoir l’une des valeurs suivantes :
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
iFSTextEffectMSec
Type : DWORD
Windows 95/98 : Spécifie la durée, en millisecondes, du signal visuel qui s’affiche lorsqu’une application en mode texte plein écran génère un son.
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
iFSTextEffectColorBits
Type : DWORD
Windows 95/98 : Spécifie la valeur RVB de la couleur à utiliser lors de l’affichage du signal visuel affiché lorsqu’une application en mode texte plein écran génère un son.
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
iFSGrafEffect
Type : DWORD
Windows 95/98 : Spécifie le signal visuel à présenter lorsqu’une application en mode graphique génère un son lors de l’exécution sur une machine virtuelle plein écran. Ce membre peut avoir l’une des valeurs suivantes :
| Valeur | Signification |
|---|---|
|
Flashez l’affichage entier. |
|
Aucun signal visuel. |
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
iFSGrafEffectMSec
Type : DWORD
Windows 95/98 : Spécifie la durée, en millisecondes, du signal visuel qui s’affiche lorsqu’une application en mode graphique plein écran génère un son.
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
iFSGrafEffectColor
Type : DWORD
Windows 95/98 : Spécifie la valeur RVB de la couleur à utiliser lors de l’affichage du signal visuel affiché lorsqu’une application en mode graphique plein écran génère un son.
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
iWindowsEffect
Type : DWORD
Spécifie le signal visuel à afficher lorsqu’un son est généré par une application Windows ou une application MS-DOS exécutée dans une fenêtre. Ce membre peut avoir l’une des valeurs suivantes :
iWindowsEffectMSec
Type : DWORD
Windows 95/98 : Spécifie la durée, en millisecondes, du signal visuel affiché lorsqu’une application Win32 (ou une application s’exécutant dans une fenêtre) génère un son.
Windows NT/2000 : Ce membre est réservé pour une utilisation ultérieure. Elle doit être définie sur zéro.
lpszWindowsEffectDLL
Type : LPTSTR
Ce membre est réservé pour un usage ultérieur. Elle doit avoir la valeur NULL.
iWindowsEffectOrdinal
Type : DWORD
Ce membre est réservé pour un usage ultérieur. Il doit être défini sur zéro.
Remarques
Une application utilise une structure SOUNDSENTRY lors de l’appel de la fonction SystemParametersInfo avec le paramètre uiAction défini sur SPI_GETSOUNDSENTRY ou SPI_SETSOUNDSENTRY. Lors de l’utilisation de SPI_GETSOUNDSENTRY, une application doit spécifier le membre cbSize de la structure SOUNDSENTRY ; la fonction SystemParametersInfo remplit les membres restants. Une application doit spécifier les membres cbSize, dwFlags et iWindowsEffect lors de l’utilisation de la valeur SPI_SETSOUNDSENTRY .
Notes
L’en-tête winuser.h définit SOUNDSENTRY comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | winuser.h (inclure Windows.h) |