SOUNDSENTRYW-Struktur (winuser.h)

Enthält Informationen zum Barrierefreiheitsfeature von SoundSentry. Wenn das SoundSentry-Feature aktiviert ist, zeigt der Computer nur dann eine visuelle Anzeige an, wenn ein Sound generiert wird.

Windows 95/98: Die visuelle Anzeige wird angezeigt, wenn ein Sound über den internen Lautsprecher des Computers generiert wird.

Windows NT/2000: Die visuelle Anzeige wird angezeigt, wenn ein Sound entweder über die Multimedia-Sounddienste oder über den Lautsprecher des Computers generiert wird.

Syntax

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;

Angehörige

cbSize

Typ: UINT-

Gibt die Größe dieser Struktur in Bytes an.

dwFlags

Typ: DWORD-

Eine Reihe von Bitkennzeichnungen, die Eigenschaften des SoundSentry-Features angeben. Die folgenden Bit-Flag-Werte werden definiert:

iFSTextEffect

Typ: DWORD-

Windows 95/98: Gibt das visuelle Signal an, das angezeigt werden soll, wenn eine Textmodusanwendung einen Sound generiert, während sie auf einem virtuellen Vollbildcomputer ausgeführt wird. Dieses Element kann einer der folgenden Werte sein:

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

iFSTextEffectMSec

Typ: DWORD-

Windows 95/98: Gibt die Dauer des visuellen Signals in Millisekunden an, das angezeigt wird, wenn eine Anwendung im Vollbildmodus einen Sound generiert.

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

iFSTextEffectColorBits

Typ: DWORD-

Windows 95/98: Gibt den RGB-Wert der Farbe an, die beim Anzeigen des visuellen Signals verwendet werden soll, wenn eine Vollbildmodusanwendung einen Sound generiert.

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

iFSGrafEffect

Typ: DWORD-

Windows 95/98: Gibt das visuelle Signal an, das angezeigt werden soll, wenn eine Grafikmodusanwendung einen Sound generiert, während sie auf einem virtuellen Vollbildcomputer ausgeführt wird. Dieses Element kann einer der folgenden Werte sein:

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

iFSGrafEffectMSec

Typ: DWORD-

Windows 95/98: Gibt die Dauer des visuellen Signals in Millisekunden an, das angezeigt wird, wenn eine Vollbildmodusanwendung einen Sound generiert.

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

iFSGrafEffectColor

Typ: DWORD-

Windows 95/98: Gibt den RGB-Wert der Farbe an, die beim Anzeigen des visuellen Signals verwendet werden soll, wenn eine Vollbildmodusanwendung einen Sound generiert.

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

iWindowsEffect

Typ: DWORD-

Gibt das visuelle Signal an, das angezeigt werden soll, wenn ein Sound von einer Windows-basierten Anwendung oder einer MS-DOS-Anwendung generiert wird, die in einem Fenster ausgeführt wird. Dieses Element kann einer der folgenden Werte sein:

iWindowsEffectMSec

Typ: DWORD-

Windows 95/98: Gibt die Dauer des visuellen Signals in Millisekunden an, das angezeigt wird, wenn eine Win32-basierte Anwendung (oder eine Anwendung, die in einem Fenster ausgeführt wird) einen Sound generiert.

Windows NT/2000: Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

lpszWindowsEffectDLL

Typ: LPTSTR-

Dieses Mitglied ist für die zukünftige Verwendung reserviert. Es sollte auf NULL-festgelegt werden.

iWindowsEffectOrdinal

Typ: DWORD-

Dieses Mitglied ist für die zukünftige Verwendung reserviert. Er muss auf Null festgelegt werden.

Bemerkungen

Eine Anwendung verwendet beim Aufrufen der SystemParametersInfo-Funktion eine SOUNDSENTRY- Struktur, wobei der parameter uiAction auf SPI_GETSOUNDSENTRY oder SPI_SETSOUNDSENTRYfestgelegt ist. Bei Verwendung von SPI_GETSOUNDSENTRYmuss eine Anwendung das cbSize Member der SOUNDSENTRY- Struktur angeben; die SystemParametersInfo Funktion füllt die verbleibenden Elemente aus. Eine Anwendung muss die cbSize, dwFlagsund iWindowsEffect Member angeben, wenn sie den SPI_SETSOUNDSENTRY Wert verwenden.

Anforderungen

Siehe auch

Barrierefreiheitsstrukturen

SoundSentryProc

SystemParametersInfo-