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

要件

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

こちらもご覧ください

アクセシビリティ構造

SoundSentryProc

SystemParametersInfo