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 または Unicode バージョンを自動的に選択するエイリアスとして SOUNDSENTRY を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header winuser.h (Windows.h を含む)

関連項目

アクセシビリティ構造

SoundSentryProc

SystemParametersInfo