次の方法で共有

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 [デスクトップ アプリのみ]
ヘッダー winuser.h (Windows.h を含む)

関連項目

アクセシビリティ構造

SoundSentryProc

SystemParametersInfo