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

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

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