ВИЗУАЛЬНЫЕ ОПОВЕЩЕНИЯ

Визуальные оповещения структура содержит информацию о специальной функции оповещения. Когда включена функция оповещения, компьютер отображает визуальную индикацию только тогда, когда звук генерируется.

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

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

typedef struct tagSOUNDSENTRY {/ / СС UINT cbSize; 
    DWORD dwFlags; 
    DWORD iFSTextEffect; 
    DWORD iFSTextEffectMSec; 
    DWORD iFSTextEffectColorBits; 
    DWORD iFSGrafEffect; 
    DWORD iFSGrafEffectMSec; 
    DWORD iFSGrafEffectColor; 
    DWORD iWindowsEffect; 
    DWORD iWindowsEffectMSec; 
    LPTSTR lpszWindowsEffectDLL; 
    DWORD iWindowsEffectOrdinal; 
} ОПОВЕЩЕНИЯ, * LPSOUNDSENTRY 
 

Члены

cbSize
Указывает размер в байтах этой структуры.
dwFlags
Набор битовых флагов, которые определяют свойства функцию оповещения. Определяются следующие значения битовых флагов:
Значение Значение
SSF_AVAILABLE Если этот флаг установлен, функция оповещения доступна.
SSF_SOUNDSENTRYON Если этот флаг установлен, визуальные оповещения находится на.

iFSTextEffect
Windows 95: Определяет визуальный сигнал когда текстовом режиме приложение генерирует звук во время выполнения в полный экран виртуальной машины. Этот член может быть одним из следующих значений
Значение Значение
SSTF_BORDER Флэш-границы экрана (то есть область переразвертки), который недоступен на некоторых дисплеев.
SSTF_CHARS Флэш-символов в углу экрана.
SSTF_DISPLAY Флэш-весь экран.
SSTF_NONE Нет визуального сигнала.

Windows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

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

Wndows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

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

Windows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

iFSGrafEffect
Windows 95: Определяет визуальный сигнал когда графическом режиме приложение генерирует звук во время выполнения в полный экран виртуальной машины. Этот член может быть одним из следующих значений
Значение Значение
SSGF_DISPLAY Нет визуального сигнала.
SSGF_NONE Флэш-весь экран.

Windows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

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

Windows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

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

Windows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

iWindowsEffect
Определяет визуальный сигнал для отображения, когда звук генерируется приложение Windows или приложение MS-DOS работает в окне. Этот член может быть одним из следующих значений:
Значение Значение
SSWF_CUSTOM Вызовите процедуру SoundSentryProc , экспортируемой DLL, указанный член iFSWindowsEffectDLL.
SSWF_DISPLAY Флэш-весь экран.
SSWF_NONE Нет визуального сигнала.
SSWF_TITLE Флэш-заголовка активного окна.
SSWF_WINDOW Флэш-активное окно.

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

Windows NT: Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

lpszWindowsEffectDLL
Указывает буфер, содержащий имя библиотеки DLL, содержащего функцию обратного вызова SoundSentryProc . Длина имени не должна превышать значение MAX_PATH. Этот элемент имеет значение NULL, если используется не DLL. При получении информации о функции оповещения, размер буфера должен быть равен или больше, чем значение MAX_PATH.
iWindowsEffectOrdinal
Этот член зарезервирован для использования в будущем. Он должен быть установлен на 0.

Примечания

Приложение использует структуру визуальные оповещения при вызове функции SystemParametersInfo с параметром wAction , SPI_GETSOUNDSENTRY или SPI_SETSOUNDSENTRY. При использовании SPI_GETSOUNDSENTRY, приложение должно указать член cbSize структуры визуальные оповещения ; SystemParametersInfo функция заполняет оставшихся членов. При использовании значения SPI_SETSOUNDSENTRY приложение необходимо указать cbSize, dwFlagsи iWindowsEffect члены.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winuser.h.
Юникод:Определяется как структуры Unicode и ANSI.

Родственные слова

Обзор доступности, доступность структур, SoundSentryProc, SystemParametersInfo