Compartilhar via

Estrutura SOUNDSENTRYA (winuser.h)

  • Artigo

Contém informações sobre o recurso de acessibilidade SoundSentry. Quando o recurso SoundSentry está ativado, o computador exibe uma indicação visual somente quando um som é gerado.

Windows 95/98: A indicação visual é exibida quando um som é gerado por meio do alto-falante interno do computador.

Windows NT/2000: A indicação visual é exibida quando um som é gerado por meio dos serviços de som multimídia ou por meio do alto-falante do computador.

Sintaxe

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;

Membros

cbSize

Tipo: UINT

Especifica o tamanho, em bytes, dessa estrutura.

dwFlags

Tipo: DWORD

Um conjunto de sinalizadores de bits que especificam propriedades do recurso SoundSentry. Os seguintes valores de sinalizador de bit são definidos:

Valor Significado
SSF_AVAILABLE
0x00000002
 Se esse sinalizador estiver definido, o recurso SoundSentry estará disponível.
SSF_INDICATOR
0x00000004
 Esse sinalizador não é implementado.
SSF_SOUNDSENTRYON
0x00000001
 Se esse sinalizador estiver definido, o recurso SoundSentry estará ativado.

iFSTextEffect

Tipo: DWORD

Windows 95/98: Especifica o sinal visual a ser apresentado quando um aplicativo de modo de texto gera um som durante a execução em uma máquina virtual de tela inteira. Esse membro pode ser um dos seguintes valores:

Valor Significado
SSTF_BORDER
2
 Flash a borda da tela (ou seja, a área de sobrescan), que não está disponível em algumas exibições.
SSTF_CHARS
1
 Caracteres flash no canto da tela.
SSTF_DISPLAY
3
 Mostrar a tela inteira.
SSTF_NONE
0
 Nenhum sinal visual
 

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

iFSTextEffectMSec

Tipo: DWORD

Windows 95/98: Especifica a duração, em milissegundos, do sinal visual exibido quando um aplicativo de modo de texto em tela inteira gera um som.

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

iFSTextEffectColorBits

Tipo: DWORD

Windows 95/98: Especifica o valor RGB da cor a ser usada ao exibir o sinal visual mostrado quando um aplicativo de modo de texto em tela inteira gera um som.

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

iFSGrafEffect

Tipo: DWORD

Windows 95/98: Especifica o sinal visual a ser apresentado quando um aplicativo de modo gráfico gera um som durante a execução em uma máquina virtual de tela inteira. Esse membro pode ser um dos seguintes valores:

Valor Significado
SSGF_DISPLAY
3
 Mostrar a tela inteira.
SSGF_NONE
0
 Nenhum sinal visual.
 

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

iFSGrafEffectMSec

Tipo: DWORD

Windows 95/98: Especifica a duração, em milissegundos, do sinal visual exibido quando um aplicativo de modo gráfico de tela inteira gera um som.

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

iFSGrafEffectColor

Tipo: DWORD

Windows 95/98: Especifica o valor RGB da cor a ser usada ao exibir o sinal visual mostrado quando um aplicativo de modo gráfico de tela inteira gera um som.

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

iWindowsEffect

Tipo: DWORD

Especifica o sinal visual a ser exibido quando um som é gerado por um aplicativo baseado no Windows ou um aplicativo MS-DOS em execução em uma janela. Esse membro pode ser um dos seguintes valores:

Valor Significado
SSWF_CUSTOM
4
 Use um sinal visual personalizado.
SSWF_DISPLAY
3
 Mostrar a tela inteira.
SSWF_NONE
0
 Nenhum sinal visual.
SSWF_TITLE
1
 Mostrar a barra de título da janela ativa.
SSWF_WINDOW
2
 Flash da janela ativa.

iWindowsEffectMSec

Tipo: DWORD

Windows 95/98: Especifica a duração, em milissegundos, do sinal visual exibido quando um aplicativo baseado em Win32 (ou um aplicativo em execução em uma janela) gera um som.

Windows NT/2000: Esse membro é reservado para uso futuro. Ele deve ser definido como zero.

lpszWindowsEffectDLL

Tipo: LPTSTR

Este membro é reservado para uso futuro. Ele deve ser definido como NULL.

iWindowsEffectOrdinal

Tipo: DWORD

Este membro é reservado para uso futuro. Ele deve ser definido como zero.

Comentários

Um aplicativo usa uma estrutura SOUNDSENTRY ao chamar a função SystemParametersInfo com o parâmetro uiAction definido como SPI_GETSOUNDSENTRY ou SPI_SETSOUNDSENTRY. Ao usar SPI_GETSOUNDSENTRY, um aplicativo deve especificar o membro cbSize da estrutura SOUNDSENTRY ; a função SystemParametersInfo preenche os membros restantes. Um aplicativo deve especificar os membros cbSize, dwFlags e iWindowsEffect ao usar o valor SPI_SETSOUNDSENTRY .

Observação

O cabeçalho winuser.h define SOUNDSENTRY como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho winuser.h (inclua Windows.h)

Confira também

Estruturas de acessibilidade

SoundSentryProc

SystemParametersInfo