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： 此成員保留供日後使用。 它必須設定為零。

iFSTextEffectMSec

類型： DWORD

Windows 95/98： 指定全螢幕文字模式應用程式產生音效時所顯示的視覺訊號持續時間，以毫秒為單位。

Windows NT/2000： 此成員保留供日後使用。 它必須設定為零。

iFSTextEffectColorBits

類型： DWORD

Windows 95/98： 指定當全螢幕文字模式應用程式產生音效時，顯示顯示視覺訊號時所要使用的色彩 RGB 值。

Windows NT/2000： 此成員保留供日後使用。 它必須設定為零。

iFSGrafEffect

類型： DWORD

Windows 95/98： 指定圖形模式應用程式在全螢幕虛擬機器中執行時產生音效時要呈現的視覺訊號。 這個成員可以是下列其中一個值：

值 意義
SSGF_DISPLAY
3
 閃爍整個顯示器。
SSGF_NONE
0
 沒有視覺訊號。
 

Windows NT/2000： 此成員保留供日後使用。 它必須設定為零。

iFSGrafEffectMSec

類型： DWORD

Windows 95/98： 指定全螢幕圖形模式應用程式產生音效時所顯示的視覺訊號持續時間，以毫秒為單位。

Windows NT/2000： 此成員保留供日後使用。 它必須設定為零。

iFSGrafEffectColor

類型： DWORD

Windows 95/98： 指定當全螢幕圖形模式應用程式產生音效時，顯示顯示視覺訊號時所要使用的色彩 RGB 值。

Windows NT/2000： 此成員保留供日後使用。 它必須設定為零。

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： 此成員保留供日後使用。 它必須設定為零。

lpszWindowsEffectDLL

類型： LPTSTR

這個成員保留供未來使用。 它應該設定為 Null。

iWindowsEffectOrdinal

類型： DWORD

這個成員保留供未來使用。 它必須設定為零。

備註

應用程式會在呼叫SystemParametersInfo函式時使用SOUNDSENTRY結構，並將uiAction參數設定為SPI_GETSOUNDSENTRY或SPI_SETSOUNDSENTRY。 使用SPI_GETSOUNDSENTRY時，應用程式必須指定SOUNDSENTRY結構的cbSize成員;SystemParametersInfo函式會填滿其餘成員。 使用SPI_SETSOUNDSENTRY值時，應用程式必須指定cbSize、dwFlags和iWindowsEffect成員。

注意

winuser.h 標頭會將 SOUNDSENTRY 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 winuser.h (包含 Windows.h)

另請參閱

協助工具結構

SoundSentryProc

SystemParametersInfo