다음을 통해 공유

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
 일부 디스플레이에서는 사용할 수 없는 화면 테두리(즉, 오버스캔 영역)를 플래시합니다.
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