Share via

Structure SOUNDSENTRYW (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 tagSOUNDSENTRYW {
  UINT   cbSize;
  DWORD  dwFlags;
  DWORD  iFSTextEffect;
  DWORD  iFSTextEffectMSec;
  DWORD  iFSTextEffectColorBits;
  DWORD  iFSGrafEffect;
  DWORD  iFSGrafEffectMSec;
  DWORD  iFSGrafEffectColor;
  DWORD  iWindowsEffect;
  DWORD  iWindowsEffectMSec;
  LPWSTR lpszWindowsEffectDLL;
  DWORD  iWindowsEffectOrdinal;
} SOUNDSENTRYW, *LPSOUNDSENTRYW;

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 d’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 (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’ensemble de l’affichage.
SSTF_NONE
0
 Aucun signal visuel
 

Windows NT/2000 : Ce membre est réservé à une utilisation ultérieure. Il doit être défini 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é à une utilisation ultérieure. Il doit être défini 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é à une utilisation ultérieure. Il doit être défini 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 d’une machine virtuelle en plein écran. Ce membre peut être l’une des valeurs suivantes :

Valeur Signification
SSGF_DISPLAY
3
 Flashez l’ensemble de l’affichage.
SSGF_NONE
0
 Aucun signal visuel.
 

Windows NT/2000 : Ce membre est réservé à une utilisation ultérieure. Il doit être défini 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. Il doit être défini 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. Il doit être défini 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 être l’une des valeurs suivantes :

Valeur Signification
SSWF_CUSTOM
4
 Utilisez un signal visuel personnalisé.
SSWF_DISPLAY
3
 Flashez l’ensemble de l’affichage.
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 qui s’affiche 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. Il doit être défini 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.

Configuration requise

Condition requise Valeur
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