SKJERMSIGNAL

SKJERMSIGNAL strukturen inneholder informasjon om funksjonen for Skjermsignal-tilgjengelighet. Når funksjonen Skjermsignal er på, viser datamaskinen en visuell indikasjon om bare når en lyd genereres.

Windows 95: Visuell indikasjon vises når en lyd som genereres gjennom datamaskinens interne høyttaler.

Windows NT: Visuell indikasjon vises når en lyd som genereres gjennom enten multimedia lyd tjenestene eller gjennom datamaskinens høyttaler.

typeDef struct tagSOUNDSENTRY {/ / ss UINT cbSize; 
    DWORD dwFlags; 
    DWORD iFSTextEffect; 
    DWORD iFSTextEffectMSec; 
    DWORD iFSTextEffectColorBits; 
    DWORD iFSGrafEffect; 
    DWORD iFSGrafEffectMSec; 
    DWORD iFSGrafEffectColor; 
    DWORD iWindowsEffect; 
    DWORD iWindowsEffectMSec; 
    LPTSTR lpszWindowsEffectDLL; 
    DWORD iWindowsEffectOrdinal; 
} SKJERMSIGNAL, * LPSOUNDSENTRY 

 

Medlemmer

cbSize

Angir størrelsen, i byte, på denne strukturen.

dwFlags

Et sett med Bitflagg som angir egenskapene for Skjermsignal-funksjonen. Følgende bit-flagg verdiene er definert:

Verdi	Betydning
SSF_AVAILABLE	Hvis dette flagget er angitt, er Skjermsignal-funksjonen tilgjengelig.
SSF_SOUNDSENTRYON	Hvis dette flagget er angitt, er funksjonen Skjermsignal på.

iFSTextEffect

Windows 95: Angir visuelle signalet til å presentere når en tekst-modusen programmet genererer en lyd mens du kjører i en virtuell maskin for full skjerm. Dette medlemmet kan være en av følgende verdier

Verdi	Betydning
SSTF_BORDER	Flash skjermen grensen (det vil si overskanning området), som er tilgjengelig på noen skjermer.
SSTF_CHARS	Flash tegn i hjørnet av skjermen.
SSTF_DISPLAY	Flash hele skjermen.
SSTF_NONE	Ikke noe visuelt signal.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

iFSTextEffectMSec

Windows 95: Angir varigheten i millisekunder i visuelle signalet som vises når en fullskjerm-, tekst-modusen programmet genererer en lyd.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

iFSTextEffectColorBits

Windows 95: Angir RGB-verdien for fargen som skal brukes ved visning av visuelle signalet vist når en fullskjerm-, tekst-modusen programmet genererer en lyd.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

iFSGrafEffect

Windows 95: Angir visuelle signalet til å presentere når en grafikkmodus programmet genererer en lyd mens du kjører i en virtuell maskin for full skjerm. Dette medlemmet kan være en av følgende verdier

Verdi	Betydning
SSGF_DISPLAY	Ikke noe visuelt signal.
SSGF_NONE	Flash hele skjermen.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

iFSGrafEffectMSec

Windows 95: Angir varigheten i millisekunder i visuelle signalet som vises når en fullskjerm-, grafikk-modusen programmet genererer en lyd.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

iFSGrafEffectColor

Windows 95: Angir RGB-verdien for fargen som skal brukes ved visning av visuelle signalet vist når en fullskjerm-, grafikk-modusen programmet genererer en lyd.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

iWindowsEffect

Angir visuelle signalet skal vises når en lyd som er generert av en Windows-basert program eller et MS-DOS-program som kjøres i et vindu. Dette medlemmet kan være en av følgende verdier:

Verdi	Betydning
SSWF_CUSTOM	Kall SoundSentryProc -rutine som eksporteres av DLLEN som er angitt av iFSWindowsEffectDLL -medlemmet.
SSWF_DISPLAY	Flash hele skjermen.
SSWF_NONE	Ikke noe visuelt signal.
SSWF_TITLE	Flash tittellinjen i det aktive vinduet.
SSWF_WINDOW	Flash det aktive vinduet.

iWindowsEffectMSec

Windows 95: Angir varigheten i millisekunder i visuelle signalet som vises når en Win32-basert program (eller et program som kjøres i et vindu) genererer en lyd.

Windows NT: Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

lpszWindowsEffectDLL

Poeng til bufferen som inneholder navnet på DLL-filen som inneholder en funksjon for SoundSentryProc -tilbakekall. Navnet må ikke overstige verdien for MAX_PATH. Dette medlemmet er NULL hvis noen DLL-fil er brukt. Når du henter informasjon om funksjonen for Skjermsignal, må størrelsen på bufferen være lik eller større enn, verdien av MAX_PATH.

iWindowsEffectOrdinal

Dette medlemmet er reservert for fremtidig bruk. Det må være satt til null.

Merknader

Et program bruker en struktur for SKJERMSIGNAL når du kaller funksjonen SystemParametersInfo med wAction -parameteren angitt til SPI_GETSOUNDSENTRY eller SPI_SETSOUNDSENTRY. Når du bruker SPI_GETSOUNDSENTRY, må et program angi cbSize -medlem av strukturen SKJERMSIGNAL ; funksjonen SystemParametersInfo fyller de gjenværende medlemmene. Et program må angi medlemmene cbSize, dwFlagsog iWindowsEffect når du bruker SPI_SETSOUNDSENTRY-verdi.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Unicode:Definert som Unicode- og ANSI-strukturer.

Se også

Tilgjengelighet, oversikt, tilgjengelighet strukturer, SoundSentryProc, SystemParametersInfo