Struttura SOUNDSENTRYA (winuser.h)

  • Articolo

Contiene informazioni sulla funzionalità di accessibilità SoundSentry. Quando la funzionalità SoundSentry è attiva, 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;

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. I valori del flag di bit seguenti sono definiti:

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

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
 Flashare il bordo dello schermo ,ovvero l'area overscan, che non è disponibile in alcuni display.
SSTF_CHARS
1
 Caratteri flash nell'angolo dello schermo.
SSTF_DISPLAY
3
 Flash l'intero display.
SSTF_NONE
0
 Nessun segnale visivo
 

Windows NT/2000: Questo membro è riservato per l'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 a schermo intero e in modalità testo genera un suono.

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

iFSTextEffectColorBits

Tipo: DWORD

Windows 95/98: Specifica il valore RGB del colore da usare durante la visualizzazione del segnale visivo visualizzato quando un'applicazione in modalità testo completa genera un suono.

Windows NT/2000: Questo membro è riservato per l'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
 Flash l'intero display.
SSGF_NONE
0
 Nessun segnale visivo.
 

Windows NT/2000: Questo membro è riservato per l'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 a schermo intero e in modalità grafica genera un suono.

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

iFSGrafEffectColor

Tipo: DWORD

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

Windows NT/2000: Questo membro è riservato per l'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
 Flash l'intero display.
SSWF_NONE
0
 Nessun segnale visivo.
SSWF_TITLE
1
 Flash la barra del titolo della finestra attiva.
SSWF_WINDOW
2
 Flash 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 l'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 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
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