Поделиться через

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

  • Статья

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

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

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

Синтаксис

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;

Члены

cbSize

Тип: UINT

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

dwFlags

Тип: DWORD

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

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

iFSTextEffect

Тип: DWORD

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

Ценность Значение
SSTF_BORDER
2
 Мигает границу экрана (т. е. область overscan), которая недоступна на некоторых дисплеях.
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 uiAction, равным SPI_GETSOUNDSENTRY или SPI_SETSOUNDSENTRY. При использовании SPI_GETSOUNDSENTRYприложение должно указать cbSize член структуры SOUNDSENTRY; функция SystemParametersInfo заполняет остальные элементы. Приложение должно указать cbSize, dwFlagsи членов iWindowsEffect при использовании значения SPI_SETSOUNDSENTRY.

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
заголовка winuser.h (включая Windows.h)

См. также

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

SoundSentryProc

SystemParametersInfo