SoundSentryProc函式是一個庫定義的回調函式,當SOUNDSENTRY易用特性存在,並且一個基於win32的應用程式(或者在視窗內運行的應用程式)通過計算機的內置揚聲器發聲時,它產生一個控制的可視化訊息。
基本介紹
- 外文名:SoundSentryProc
- 解釋:函式功能
- 類型:一個庫定義的回調函式
- 產生:一個控制的可視化訊息
函式原型,參數,返回值,備註,速查,
函式原型
LRESULT CALLBACK SOUNDSENTRYProc(DWORD dwMillisec,DWORD fdwEffect);
參數
dwMillisec:指定可視化訊息的持續時間,以毫秒為單位。該訊息是在一個基於win32的應用程式(或運行在視窗的應用程式)發聲時顯示出來的。
fdwEffect:指定要顯示的可視化訊息的類型。當前值通常應為SSWF_CUSTOM。
返回值
如果可視化訊息已經或將要正確顯示,那么返回值為TRUE,如果訊息異步,並當調用該函式時其狀態無效,那么應該返回TRUE。如果出錯使得訊息無法顯示,那么返回值為FALSE。若想獲得更多錯誤信息,請調用GetLastError函式。
備註
包含SoundSentryProc函式的庫必須是一個32位的DLL,並且該 DLL必須導出名為SoundSentryProc的函式,即供外部調用和連線。SoundSentryProc函式只是在應用程式或庫調用SystemParameterslnfo函式之後才調用。SystemParameterslnfo函式指定SPI_SETSOUNDSENTRY項的值以及SOUNDSENTRY結構的地址,在SOUNDSENTRY結構中,成員iWindowsEffect的值設為SSWF_CUSTOM。
速查
Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;庫檔案:用戶自定義。