Structure SOUNDSENTRYA (winuser.h)

  • Article

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 :

Valeur Signification
SSF_AVAILABLE
0x00000002
 Si cet indicateur est défini, la fonctionnalité SoundSentry est disponible.
SSF_INDICATOR
0x00000004
 Cet indicateur n’est pas implémenté.
SSF_SOUNDSENTRYON
0x00000001
 Si cet indicateur est défini, la fonctionnalité SoundSentry est activée.

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 :

Valeur Signification
SSTF_BORDER
2
 Flashez la bordure de l’écran (c’est-à-dire la zone de suranalyse), qui n’est pas disponible sur certains écrans.
SSTF_CHARS
1
 Caractères flash dans le coin de l’écran.
SSTF_DISPLAY
3
 Flashez l’affichage entier.
SSTF_NONE
0
 Aucun signal visuel
 

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
SSGF_DISPLAY
3
 Flashez l’affichage entier.
SSGF_NONE
0
 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 :

Valeur Signification
SSWF_CUSTOM
4
 Utilisez un signal visuel personnalisé.
SSWF_DISPLAY
3
 Flashez l’affichage entier.
SSWF_NONE
0
 Aucun signal visuel.
SSWF_TITLE
1
 Flashez la barre de titre de la fenêtre active.
SSWF_WINDOW
2
 Flasher la fenêtre active.

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)

Voir aussi

Structures d’accessibilité

SoundSentryProc

SystemParametersInfo