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 기능의 속성을 지정하는 비트 플래그 집합입니다. 다음 비트 플래그 값이 정의됩니다.
값 | 의미 |
---|---|
|
이 플래그를 설정하면 SoundSentry 기능을 사용할 수 있습니다. |
|
이 플래그는 구현되지 않습니다. |
|
이 플래그가 설정되면 SoundSentry 기능이 켜집니다. |
iFSTextEffect
형식: DWORD
Windows 95/98: 전체 화면 가상 머신에서 실행되는 동안 텍스트 모드 애플리케이션이 소리를 생성할 때 표시할 시각적 신호를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
일부 디스플레이에서 사용할 수 없는 화면 테두리(즉, 오버스카나 영역)를 플래시합니다. |
|
화면 모서리에 문자가 깜박입니다. |
|
전체 디스플레이를 플래시합니다. |
|
시각적 신호 없음 |
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
iFSTextEffectMSec
형식: DWORD
Windows 95/98: 전체 화면 텍스트 모드 애플리케이션에서 소리를 생성할 때 표시되는 시각적 신호의 지속 시간(밀리초)을 지정합니다.
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
iFSTextEffectColorBits
형식: DWORD
Windows 95/98: 전체 화면 텍스트 모드 애플리케이션에서 소리를 생성할 때 표시되는 시각적 신호를 표시할 때 사용할 색의 RGB 값을 지정합니다.
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
iFSGrafEffect
형식: DWORD
Windows 95/98: 그래픽 모드 애플리케이션이 전체 화면 가상 머신에서 실행되는 동안 소리를 생성할 때 표시할 시각적 신호를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
전체 디스플레이를 플래시합니다. |
|
시각적 신호가 없습니다. |
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
iFSGrafEffectMSec
형식: DWORD
Windows 95/98: 전체 화면 그래픽 모드 애플리케이션에서 소리를 생성할 때 표시되는 시각적 신호의 지속 시간(밀리초)을 지정합니다.
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
iFSGrafEffectColor
형식: DWORD
Windows 95/98: 전체 화면 그래픽 모드 애플리케이션에서 소리를 생성할 때 표시되는 시각적 신호를 표시할 때 사용할 색의 RGB 값을 지정합니다.
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
iWindowsEffect
형식: DWORD
Windows 기반 애플리케이션 또는 창에서 실행되는 MS-DOS 애플리케이션에서 소리가 생성될 때 표시할 시각적 신호를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
사용자 지정 시각적 신호를 사용합니다. |
|
전체 디스플레이를 플래시합니다. |
|
시각적 신호가 없습니다. |
|
활성 창의 제목 표시줄을 플래시합니다. |
|
활성 창을 플래시합니다. |
iWindowsEffectMSec
형식: DWORD
Windows 95/98: Win32 기반 애플리케이션(또는 창에서 실행되는 애플리케이션)이 소리를 생성할 때 표시되는 시각적 신호의 지속 시간(밀리초)을 지정합니다.
Windows NT/2000: 이 멤버는 나중에 사용할 수 있습니다. 0으로 설정해야 합니다.
lpszWindowsEffectDLL
형식: LPTSTR
이 멤버는 나중에 사용하도록 예약되어 있습니다. NULL로 설정해야 합니다.
iWindowsEffectOrdinal
형식: DWORD
이 멤버는 나중에 사용하도록 예약되어 있습니다. 0으로 설정해야 합니다.
설명
애플리케이션은 uiAction 매개 변수가 SPI_GETSOUNDSENTRY 또는SPI_SETSOUNDSENTRY 설정된 SystemParametersInfo 함수를 호출할 때 SOUNDSENTRY 구조를 사용합니다. SPI_GETSOUNDSENTRY 사용하는 경우 애플리케이션은 SOUNDSENTRY 구조의 cbSize 멤버를 지정해야 합니다. SystemParametersInfo 함수는 나머지 멤버를 채웁니다. 애플리케이션은 SPI_SETSOUNDSENTRY 값을 사용할 때 cbSize, dwFlags 및 iWindowsEffect 멤버를 지정해야 합니다.
참고
winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SOUNDSENTRY를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
머리글 | winuser.h(Windows.h 포함) |