Структура 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. Определены следующие значения битового флага:
iFSTextEffect
Тип: DWORD
Windows 95/98: Указывает визуальный сигнал, который будет представлен, когда приложение в текстовом режиме создает звук во время работы на полноэкранной виртуальной машине. Этот элемент может иметь одно из следующих значений:
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: Указывает визуальный сигнал, который будет показано, когда приложение в режиме графики создает звук во время работы на полноэкранной виртуальной машине. Этот элемент может иметь одно из следующих значений:
Значение | Значение |
---|---|
|
Вспыхивает весь дисплей. |
|
Нет визуального сигнала. |
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, работающим в окне. Этот элемент может иметь одно из следующих значений:
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) |