Condividi tramite

Struttura SOUNDSENTRYA (winuser.h)

  • Articolo

Contiene informazioni sulla funzionalità di accessibilità SoundSentry. Quando la funzionalità SoundSentry è attivata, il computer visualizza un'indicazione visiva solo quando viene generato un suono.

Windows 95/98: L'indicazione visiva viene visualizzata quando viene generato un suono tramite l'altoparlante interno del computer.

Windows NT/2000: L'indicazione visiva viene visualizzata quando viene generato un suono tramite i servizi audio multimediali o tramite l'altoparlante del computer.

Sintassi

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;

Membri

cbSize

Tipo: UINT

Specifica le dimensioni, in byte, di questa struttura.

dwFlags

Tipo: DWORD

Set di flag di bit che specificano le proprietà della funzionalità SoundSentry. Sono definiti i valori di flag di bit seguenti:

Valore Significato
SSF_AVAILABLE
0x00000002
 Se questo flag è impostato, la funzionalità SoundSentry è disponibile.
SSF_INDICATOR
0x00000004
 Questo flag non è implementato.
SSF_SOUNDSENTRYON
0x00000001
 Se questo flag è impostato, la funzionalità SoundSentry è attivata.

iFSTextEffect

Tipo: DWORD

Windows 95/98: specifica il segnale visivo da presentare quando un'applicazione in modalità testo genera un suono durante l'esecuzione in una macchina virtuale a schermo intero. Questo membro può essere uno dei valori seguenti:

Valore Significato
SSTF_BORDER
2
 Lampeggiare il bordo dello schermo (ovvero l'area overscan), che non è disponibile in alcuni schermi.
SSTF_CHARS
1
 Caratteri flash nell'angolo dello schermo.
SSTF_DISPLAY
3
 Lampeggiare l'intero display.
SSTF_NONE
0
 Nessun segnale visivo
 

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

iFSTextEffectMSec

Tipo: DWORD

Windows 95/98: Specifica la durata, in millisecondi, del segnale visivo visualizzato quando un'applicazione in modalità testo a schermo intero genera un suono.

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

iFSTextEffectColorBits

Tipo: DWORD

Windows 95/98: Specifica il valore RGB del colore da utilizzare quando viene visualizzato il segnale visivo visualizzato quando un'applicazione in modalità testo a schermo intero genera un suono.

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

iFSGrafEffect

Tipo: DWORD

Windows 95/98: Specifica il segnale visivo da presentare quando un'applicazione in modalità grafica genera un suono durante l'esecuzione in una macchina virtuale a schermo intero. Questo membro può essere uno dei valori seguenti:

Valore Significato
SSGF_DISPLAY
3
 Lampeggiare l'intero display.
SSGF_NONE
0
 Nessun segnale visivo.
 

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

iFSGrafEffectMSec

Tipo: DWORD

Windows 95/98: Specifica la durata, in millisecondi, del segnale visivo visualizzato quando un'applicazione in modalità grafica a schermo intero genera un suono.

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

iFSGrafEffectColor

Tipo: DWORD

Windows 95/98: Specifica il valore RGB del colore da utilizzare quando viene visualizzato il segnale visivo visualizzato quando un'applicazione in modalità grafica a schermo intero genera un suono.

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

iWindowsEffect

Tipo: DWORD

Specifica il segnale visivo da visualizzare quando un suono viene generato da un'applicazione basata su Windows o da un'applicazione MS-DOS in esecuzione in una finestra. Questo membro può essere uno dei valori seguenti:

Valore Significato
SSWF_CUSTOM
4
 Usare un segnale visivo personalizzato.
SSWF_DISPLAY
3
 Lampeggiare l'intero display.
SSWF_NONE
0
 Nessun segnale visivo.
SSWF_TITLE
1
 Lampeggiare la barra del titolo della finestra attiva.
SSWF_WINDOW
2
 Lampeggiare la finestra attiva.

iWindowsEffectMSec

Tipo: DWORD

Windows 95/98: Specifica la durata, in millisecondi, del segnale visivo visualizzato quando un'applicazione basata su Win32 (o un'applicazione in esecuzione in una finestra) genera un suono.

Windows NT/2000: Questo membro è riservato per uso futuro. Deve essere impostato su zero.

lpszWindowsEffectDLL

Tipo: LPTSTR

Questo membro è riservato per un uso futuro. Deve essere impostato su NULL.

iWindowsEffectOrdinal

Tipo: DWORD

Questo membro è riservato per un uso futuro. Deve essere impostato su zero.

Osservazioni

Un'applicazione usa una struttura di SOUNDSENTRY quando si chiama la funzione SystemParametersInfo con il parametro uiAction impostato su SPI_GETSOUNDSENTRY o SPI_SETSOUNDSENTRY. Quando si usa SPI_GETSOUNDSENTRY, un'applicazione deve specificare il membro cbSize della struttura SOUNDSENTRY ; la funzione SystemParametersInfo riempie i membri rimanenti. Un'applicazione deve specificare il cbSize, dwFlagse iWindowsEffect membri quando si usa il valore di SPI_SETSOUNDSENTRY.

Nota

L'intestazione winuser.h definisce SOUNDSENTRY come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
intestazione winuser.h (include Windows.h)

Vedere anche

strutture di accessibilità

SoundSentryProc

SystemParametersInfo