SOUNDSENTRYA-Struktur (winuser.h)
Enthält Informationen zur SoundSentry-Barrierefreiheitsfunktion. 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 erzeugt wird.
Syntax
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;
Member
cbSize
Typ: UINT
Gibt die Größe dieser Struktur in Bytes an.
dwFlags
Typ: DWORD
Eine Reihe von Bitflags, die Eigenschaften des SoundSentry-Features angeben. Die folgenden Bitflagswerte 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. Dieser Member kann einer der folgenden Werte sein:
Windows NT/2000: Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (null) festgelegt werden.
iFSTextEffectMSec
Typ: DWORD
Windows 95/98: Gibt die Dauer des visuellen Signals in Millisekunden an, das angezeigt wird, wenn eine Vollbildanwendung im Textmodus einen Sound generiert.
Windows NT/2000: Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (null) festgelegt werden.
iFSTextEffectColorBits
Typ: DWORD
Windows 95/98: Gibt den RGB-Wert der Farbe an, die verwendet werden soll, wenn das visuelle Signal angezeigt wird, wenn eine Vollbildanwendung im Textmodus einen Sound generiert.
Windows NT/2000: Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (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. Dieser Member kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Blinken Sie den gesamten Bildschirm. |
|
Kein visuelles Signal. |
Windows NT/2000: Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (null) festgelegt werden.
iFSGrafEffectMSec
Typ: DWORD
Windows 95/98: Gibt die Dauer des visuellen Signals in Millisekunden an, das angezeigt wird, wenn eine Vollbildanwendung im Grafikmodus einen Sound generiert.
Windows NT/2000: Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (null) festgelegt werden.
iFSGrafEffectColor
Typ: DWORD
Windows 95/98: Gibt den RGB-Wert der Farbe an, die verwendet werden soll, wenn das visuelle Signal angezeigt wird, wenn eine Vollbildanwendung im Grafikmodus einen Sound generiert.
Windows NT/2000: Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (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. Dieser Member 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 Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 (null) festgelegt werden.
lpszWindowsEffectDLL
Typ: LPTSTR
Dieses Element ist für die zukünftige Verwendung reserviert. Es sollte auf NULL festgelegt werden.
iWindowsEffectOrdinal
Typ: DWORD
Dieses Element ist für die zukünftige Verwendung reserviert. Er muss auf 0 festgelegt werden.
Hinweise
Eine Anwendung verwendet eine SOUNDSENTRY-Struktur , wenn die SystemParametersInfo-Funktion aufgerufen wird, wobei der uiAction-Parameter auf SPI_GETSOUNDSENTRY oder SPI_SETSOUNDSENTRY festgelegt ist. Wenn Sie SPI_GETSOUNDSENTRY verwenden, muss eine Anwendung den cbSize-Member der SOUNDSENTRY-Struktur angeben. die SystemParametersInfo-Funktion füllt die restlichen Member aus. Eine Anwendung muss die Elemente cbSize, dwFlags und iWindowsEffect angeben, wenn sie den wert SPI_SETSOUNDSENTRY verwenden.
Hinweis
Der winuser.h-Header definiert SOUNDSENTRY als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | winuser.h (einschließlich Windows.h) |