Share via

Struttura SOUNDSENTRYW (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 un suono viene generato tramite i servizi audio multimediali o tramite l'altoparlante del computer.

Sintassi

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;

Members

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. Vengono definiti i valori del 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 usi futuri. Deve essere impostato su NULL.

iWindowsEffectOrdinal

Tipo: DWORD

Questo membro è riservato per usi futuri. Deve essere impostato su zero.

Commenti

Un'applicazione usa una struttura 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 i membri cbSize, dwFlags e iWindowsEffect quando si usa il valore 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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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)

Vedi anche

Strutture di accessibilità

SoundSentryProc

Systemparametersinfo