Структура SOUNDSENTRYA (winuser.h)

Содержит сведения о функции специальных возможностей SoundSentry. Если функция SoundSentry включена, компьютер отображает визуальное указание только при создании звука.

Windows 95/98: Визуальная индикация отображается при создании звука через внутренний динамик компьютера.

Windows NT/2000: Визуальная индикация отображается при создании звука с помощью служб мультимедиа или динамиков компьютера.

Синтаксис

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;

Члены

cbSize

Тип: UINT

Задает размер данной структуры в байтах.

dwFlags

Тип: DWORD

Набор битовых флагов, указывающих свойства функции SoundSentry. Определены следующие значения битового флага:

Значение Значение
SSF_AVAILABLE
0x00000002
Если этот флаг установлен, функция SoundSentry доступна.
SSF_INDICATOR
0x00000004
Этот флаг не реализован.
SSF_SOUNDSENTRYON
0x00000001
Если этот флаг установлен, функция SoundSentry включена.

iFSTextEffect

Тип: DWORD

Windows 95/98: Указывает визуальный сигнал, который будет представлен, когда приложение в текстовом режиме создает звук во время работы на полноэкранной виртуальной машине. Этот элемент может иметь одно из следующих значений:

Значение Значение
SSTF_BORDER
2
Включите границу экрана (т. е. область превышения), которая недоступна на некоторых дисплеях.
SSTF_CHARS
1
Символы вспышки в углу экрана.
SSTF_DISPLAY
3
Вспыхивает весь дисплей.
SSTF_NONE
0
Нет визуального сигнала
 

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

iFSTextEffectMSec

Тип: DWORD

Windows 95/98: Указывает продолжительность визуального сигнала в миллисекундах, который отображается, когда полноэкранное приложение в текстовом режиме создает звук.

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

iFSTextEffectColorBits

Тип: DWORD

Windows 95/98: Задает RGB-значение цвета, используемого при отображении визуального сигнала, отображаемого при создании звука в полноэкранном текстовом режиме приложения.

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

iFSGrafEffect

Тип: DWORD

Windows 95/98: Указывает визуальный сигнал, который будет показано, когда приложение в режиме графики создает звук во время работы на полноэкранной виртуальной машине. Этот элемент может иметь одно из следующих значений:

Значение Значение
SSGF_DISPLAY
3
Вспыхивает весь дисплей.
SSGF_NONE
0
Нет визуального сигнала.
 

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

iFSGrafEffectMSec

Тип: DWORD

Windows 95/98: Указывает длительность визуального сигнала в миллисекундах, который отображается, когда полноэкранное приложение в графическом режиме создает звук.

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

iFSGrafEffectColor

Тип: DWORD

Windows 95/98: Задает rgb-значение цвета, используемого при отображении визуального сигнала, отображаемого при создании звука в полноэкранном режиме приложения в графическом режиме.

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

iWindowsEffect

Тип: DWORD

Указывает визуальный сигнал, отображаемый при создании звука приложением windows или приложением MS-DOS, работающим в окне. Этот элемент может иметь одно из следующих значений:

Значение Значение
SSWF_CUSTOM
4
Используйте пользовательский визуальный сигнал.
SSWF_DISPLAY
3
Вспыхивает весь дисплей.
SSWF_NONE
0
Нет визуального сигнала.
SSWF_TITLE
1
Выполните заголовок активного окна.
SSWF_WINDOW
2
Активная вспышка окна.

iWindowsEffectMSec

Тип: DWORD

Windows 95/98: Указывает длительность визуального сигнала в миллисекундах, который отображается, когда приложение на основе Win32 (или приложение, работающее в окне) создает звук.

Windows NT/2000: Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

lpszWindowsEffectDLL

Тип: LPTSTR

Этот элемент зарезервирован для использования в будущем. Для него должно быть задано значение NULL.

iWindowsEffectOrdinal

Тип: DWORD

Этот элемент зарезервирован для использования в будущем. Для него необходимо задать нулевое значение.

Комментарии

Приложение использует структуру SOUNDSENTRY при вызове функции SystemParametersInfo с параметром uiAction , для SPI_GETSOUNDSENTRY илиSPI_SETSOUNDSENTRY. При использовании SPI_GETSOUNDSENTRY приложение должно указать элемент cbSize структуры SOUNDSENTRY ; Функция SystemParametersInfo заполняет остальные элементы. При использовании значения SPI_SETSOUNDSENTRY приложение должно указать члены cbSize, dwFlags и iWindowsEffect.

Примечание

Заголовок winuser.h определяет SOUNDSENTRY как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть winuser.h (включая Windows.h)

См. также раздел

Структуры специальных возможностей

SoundSentryProc

SystemParametersInfo