Share via

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 기능의 속성을 지정하는 비트 플래그 집합입니다. 다음 비트 플래그 값이 정의됩니다.

값 의미
SSF_AVAILABLE
0x00000002
 이 플래그를 설정하면 SoundSentry 기능을 사용할 수 있습니다.
SSF_INDICATOR
0x00000004
 이 플래그는 구현되지 않습니다.
SSF_SOUNDSENTRYON
0x00000001
 이 플래그가 설정되면 SoundSentry 기능이 켜집니다.

iFSTextEffect

형식: DWORD

Windows 95/98: 전체 화면 가상 머신에서 실행되는 동안 텍스트 모드 애플리케이션이 소리를 생성할 때 표시할 시각적 신호를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
SSTF_BORDER
2
 일부 디스플레이에서 사용할 수 없는 화면 테두리(즉, 오버스카나 영역)를 플래시합니다.
SSTF_CHARS
1
 화면 모서리에 문자가 깜박입니다.
SSTF_DISPLAY
3
 전체 디스플레이를 플래시합니다.
SSTF_NONE
0
 시각적 신호 없음
 

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: 그래픽 모드 애플리케이션이 전체 화면 가상 머신에서 실행되는 동안 소리를 생성할 때 표시할 시각적 신호를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
SSGF_DISPLAY
3
 전체 디스플레이를 플래시합니다.
SSGF_NONE
0
 시각적 신호가 없습니다.
 

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 애플리케이션에서 소리가 생성될 때 표시할 시각적 신호를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
SSWF_CUSTOM
4
 사용자 지정 시각적 신호를 사용합니다.
SSWF_DISPLAY
3
 전체 디스플레이를 플래시합니다.
SSWF_NONE
0
 시각적 신호가 없습니다.
SSWF_TITLE
1
 활성 창의 제목 표시줄을 플래시합니다.
SSWF_WINDOW
2
 활성 창을 플래시합니다.

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 포함)

참고 항목

접근성 구조

SoundSentryProc

SystemParametersInfo