Partager via

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é via le haut-parleur interne de l’ordinateur.

Windows NT/2000 : L’indication visuelle s’affiche lorsqu’un son est généré via les services audio multimédias ou via le 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 dans une machine virtuelle en plein écran. Ce membre peut être l’une des valeurs suivantes :

Valeur Signification
SSTF_BORDER
2
 Flashez la bordure de l’écran (autrement dit, la zone de surscan), qui n’est pas disponible sur certains affichages.
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é à 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 affiché lorsqu’une application en mode texte plein écran génère un son.

Windows NT/2000 : Ce membre est réservé à 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 intégral génère un son.

Windows NT/2000 : Ce membre est réservé à 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 dans une machine virtuelle en plein écran. Ce membre peut être 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é à 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 affiché lorsqu’une application en mode graphique plein écran génère un son.

Windows NT/2000 : Ce membre est réservé à 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é à 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 s’exécutant dans une fenêtre. Ce membre peut être 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
 Flashez 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é à une utilisation ultérieure. Elle doit être définie sur zéro.

lpszWindowsEffectDLL

Type : LPTSTR

Ce membre est réservé à une utilisation ultérieure. Elle doit être définie sur NULL .

iWindowsEffectOrdinal

Type : DWORD

Ce membre est réservé à une utilisation ultérieure. Elle doit être définie 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. Lorsque vous utilisez SPI_GETSOUNDSENTRY, une application doit spécifier le cbSize membre de la structure SOUNDSENTRY ; la fonction SystemParametersInfo remplit les membres restants. Une application doit spécifier les cbSize, dwFlagset membres iWindowsEffect lors de l’utilisation de la valeur SPI_SETSOUNDSENTRY.

Note

L’en-tête winuser.h définit SOUNDSENTRY comme 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
d’en-tête winuser.h (include Windows.h)

Voir aussi

structures d’accessibilité

SoundSentryProc

SystemParametersInfo