ID do artigo: 231298 - Última revisão: terça-feira, 13 de julho de 2004 - Revisão: 3.1

Como usar SetWaitableTimer com Visual Basic

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Recolher tudo

Sumário

Muitos programadores use a função API Sleep para pausar a execução de seus programas. Uma das desvantagens do uso de suspensão é que ele faz uma pausa o thread que o aplicativo está sendo executado, e que qualquer janela que o aplicativo tiver aberto não irá redesenhar corretamente. Isso pode apresentar uma interface de usuário unattractive para o usuário. Uma alternativa a suspensão é usar SetWaitableTimer, que permitirá que a tela redesenhar, receber mensagens DDE e assim por diante.

Mais Informações

O exemplo de código a seguir ilustra o uso da API do SetWaitableTimer.

Exemplo passo a passo

  1. Inicie um novo projeto Standard EXE no Visual Basic. O Form1 é criado por padrão.
  2. Coloque dois CommandButtons no Form1.
  3. Cole o código a seguir no módulo código do Form1:
    Option Explicit
    
    ' Sleep API is declared in the form to keep the
    ' SetWaitableTimer code in its own re-usable module.
    Private Declare Sub Sleep Lib "kernel32" ( _
        ByVal dwMilliseconds As Long)
    
    Private Sub Command1_Click()
        Command1.Enabled = False
        Wait 10 ' seconds
        Command1.Enabled = True
    End Sub
    
    Private Sub Command2_Click()
        Command2.Enabled = False
        Sleep 10000 ' milliseconds
        Command2.Enabled = True
    End Sub
    
    Private Sub Form_Load()
        With Form1
            .Height = 1400
            .Width = 2400
        End With
        With Command1
            .Move 100, 100, 2000, 300
            .Caption = "SetWaitableTimer"
        End With
        With Command2
            .Move 100, 500, 2000, 300
            .Caption = "Sleep"
        End With
    End Sub
    					
  4. A partir do menu Project , clique em Adicionar módulo para adicionar um novo módulo (Module1) para o projeto.
  5. Cole o seguinte código no Module1:
    Option Explicit
    
    Private Type FILETIME
        dwLowDateTime As Long
        dwHighDateTime As Long
    End Type
    
    Private Const WAIT_ABANDONED& = &H80&
    Private Const WAIT_ABANDONED_0& = &H80&
    Private Const WAIT_FAILED& = -1&
    Private Const WAIT_IO_COMPLETION& = &HC0&
    Private Const WAIT_OBJECT_0& = 0
    Private Const WAIT_OBJECT_1& = 1
    Private Const WAIT_TIMEOUT& = &H102&
    
    Private Const INFINITE = &HFFFF
    Private Const ERROR_ALREADY_EXISTS = 183&
    
    Private Const QS_HOTKEY& = &H80
    Private Const QS_KEY& = &H1
    Private Const QS_MOUSEBUTTON& = &H4
    Private Const QS_MOUSEMOVE& = &H2
    Private Const QS_PAINT& = &H20
    Private Const QS_POSTMESSAGE& = &H8
    Private Const QS_SENDMESSAGE& = &H40
    Private Const QS_TIMER& = &H10
    Private Const QS_MOUSE& = (QS_MOUSEMOVE _
                                Or QS_MOUSEBUTTON)
    Private Const QS_INPUT& = (QS_MOUSE _
                                Or QS_KEY)
    Private Const QS_ALLEVENTS& = (QS_INPUT _
                                Or QS_POSTMESSAGE _
                                Or QS_TIMER _
                                Or QS_PAINT _
                                Or QS_HOTKEY)
    Private Const QS_ALLINPUT& = (QS_SENDMESSAGE _
                                Or QS_PAINT _
                                Or QS_TIMER _
                                Or QS_POSTMESSAGE _
                                Or QS_MOUSEBUTTON _
                                Or QS_MOUSEMOVE _
                                Or QS_HOTKEY _
                                Or QS_KEY)
    
    Private Declare Function CreateWaitableTimer Lib "kernel32" _
        Alias "CreateWaitableTimerA" ( _
        ByVal lpSemaphoreAttributes As Long, _
        ByVal bManualReset As Long, _
        ByVal lpName As String) As Long
        
    Private Declare Function OpenWaitableTimer Lib "kernel32" _
        Alias "OpenWaitableTimerA" ( _
        ByVal dwDesiredAccess As Long, _
        ByVal bInheritHandle As Long, _
        ByVal lpName As String) As Long
        
    Private Declare Function SetWaitableTimer Lib "kernel32" ( _
        ByVal hTimer As Long, _
        lpDueTime As FILETIME, _
        ByVal lPeriod As Long, _
        ByVal pfnCompletionRoutine As Long, _
        ByVal lpArgToCompletionRoutine As Long, _
        ByVal fResume As Long) As Long
        
    Private Declare Function CancelWaitableTimer Lib "kernel32" ( _
        ByVal hTimer As Long)
        
    Private Declare Function CloseHandle Lib "kernel32" ( _
        ByVal hObject As Long) As Long
        
    Private Declare Function WaitForSingleObject Lib "kernel32" ( _
        ByVal hHandle As Long, _
        ByVal dwMilliseconds As Long) As Long
        
    Private Declare Function MsgWaitForMultipleObjects Lib "user32" ( _
        ByVal nCount As Long, _
        pHandles As Long, _
        ByVal fWaitAll As Long, _
        ByVal dwMilliseconds As Long, _
        ByVal dwWakeMask As Long) As Long
    
    Public Sub Wait(lNumberOfSeconds As Long)
        Dim ft As FILETIME
        Dim lBusy As Long
        Dim lRet As Long
        Dim dblDelay As Double
        Dim dblDelayLow As Double
        Dim dblUnits As Double
        Dim hTimer As Long
        
        hTimer = CreateWaitableTimer(0, True, App.EXEName & "Timer")
        
        If Err.LastDllError = ERROR_ALREADY_EXISTS Then
            ' If the timer already exists, it does not hurt to open it
            ' as long as the person who is trying to open it has the
            ' proper access rights.
        Else
            ft.dwLowDateTime = -1
            ft.dwHighDateTime = -1
            lRet = SetWaitableTimer(hTimer, ft, 0, 0, 0, 0)
        End If
        
        ' Convert the Units to nanoseconds.
        dblUnits = CDbl(&H10000) * CDbl(&H10000)
        dblDelay = CDbl(lNumberOfSeconds) * 1000 * 10000
        
        ' By setting the high/low time to a negative number, it tells
        ' the Wait (in SetWaitableTimer) to use an offset time as
        ' opposed to a hardcoded time. If it were positive, it would
        ' try to convert the value to GMT.
        ft.dwHighDateTime = -CLng(dblDelay / dblUnits) - 1
        dblDelayLow = -dblUnits * (dblDelay / dblUnits - _
            Fix(dblDelay / dblUnits))
        
        If dblDelayLow < CDbl(&H80000000) Then
            ' &H80000000 is MAX_LONG, so you are just making sure
            ' that you don't overflow when you try to stick it into
            ' the FILETIME structure.
            dblDelayLow = dblUnits + dblDelayLow
            ft.dwHighDateTime = ft.dwHighDateTime + 1 
        End If 
        
        ft.dwLowDateTime = CLng(dblDelayLow)
        lRet = SetWaitableTimer(hTimer, ft, 0, 0, 0, False)
        
        Do
            ' QS_ALLINPUT means that MsgWaitForMultipleObjects will
            ' return every time the thread in which it is running gets
            ' a message. If you wanted to handle messages in here you could,
            ' but by calling Doevents you are letting DefWindowProc
            ' do its normal windows message handling---Like DDE, etc.
            lBusy = MsgWaitForMultipleObjects(1, hTimer, False, _
                INFINITE, QS_ALLINPUT&)
            DoEvents
        Loop Until lBusy = WAIT_OBJECT_0
        
        ' Close the handles when you are done with them.
        CloseHandle hTimer
    
    End Sub
    					
  6. Execute o projeto.
  7. Clique no botão Dormir . Enquanto o aplicativo está em suspensão, observe que a tela não redesenhar (arraste outra janela superior do aplicativo e, em seguida, arraste-o fora). Em seguida, tente o mesmo teste com o botão SetWaitableTimer .

Referências

Para obter informações adicionais, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
184796  (http://support.microsoft.com/kb/184796/EN-US/ ) Como usar um Timer Waitable com uma chamada de procedimento assíncrona
O Microsoft Win32 Software Developers Kit documenta as chamadas SetWaitableTimer MsgWaitForMultipleObjects e API de CloseHandle.

A informação contida neste artigo aplica-se a:
  • Microsoft Visual Basic 5.0 Learning Edition
  • Microsoft Visual Basic 6.0 Learning Edition
  • Microsoft Visual Basic 5.0 Professional Edition
  • Microsoft Visual Basic 6.0 Professional Edition
  • Microsoft Visual Basic 5.0 Enterprise Edition
  • Microsoft Visual Basic Enterprise Edition for Windows 6.0
  • Microsoft Visual Basic 4.0 Professional Edition
Palavras-chave: 
kbmt kbapi kbhowto KB231298 KbMtpt
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 231298  (http://support.microsoft.com/kb/231298/en-us/ )