共用方式為

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 函式，並將 uiAction 參數設定為 SPI_GETSOUNDSENTRY 或 SPI_SETSOUNDSENTRY時，應用程式會使用 SOUNDSENTRY 結構。 使用 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