WaitForSingleObject函数
2013-09-14 17:32
375 查看
WaitForSingleObject函数
VC声明DWORD WaitForSingleObject(
HANDLE hHandle,
DWORD dwMilliseconds
);
VB声明
Declare Function WaitForSingleObject Lib "kernel32" (ByVal hHandle As Long, ByVal dwMilliseconds As Long) As Long
编辑本段说明
DWORD WINAPI WaitForSingleObject(__in HANDLE hHandle,
__in DWORD dwMilliseconds
);
参数
hHandle [in]对象句柄。可以指定一系列的对象,如Event、Job、Memory resource notification、Mutex、Process、Semaphore、Thread、Waitable timer等。当等待仍在挂起状态时,句柄被关闭,那么函数行为是未定义的。该句柄必须具有 SYNCHRONIZE 访问权限。
dwMilliseconds [in]定时时间间隔,单位为milliseconds(毫秒).如果指定一个非零值,函数处于等待状态直到hHandle 标记的对象被触发,或者时间到了。如果dwMilliseconds 为0,对象没有被触发信号,函数不会进入一个等待状态,它总是立即返回。如果dwMilliseconds 为INFINITE,对象被触发信号后,函数才会返回。
返回值
执行成功,返回值指示出引发函数返回的事件。它可能为以下值:WAIT_ABANDONED0x00000080L | The specified object is a mutex object that was not released by the thread that owned the mutex object before the owning thread terminated. Ownership of the mutex object is granted to the calling thread and the mutex state is set to nonsignaled. If the mutex was protecting persistent state information, you should check it for consistency. |
WAIT_OBJECT_00x00000000L | The state of the specified object is signaled. |
WAIT_TIMEOUT0x00000102L | The time-out interval elapsed, and the object's state is nonsignaled. |
WAIT_FAILED(DWORD)0xFFFFFFFF | The function has failed. To get extended error information, call GetLastError. |
返回值:
WAIT_ABANDONED 0x00000080:当hHandle为mutex时,如果拥有mutex的线程在结束时没有释放核心对象会引发此返回值。
WAIT_OBJECT_0 0x00000000 :核心对象已被激活
WAIT_TIMEOUT 0x00000102:等待超时
WAIT_FAILED 0xFFFFFFFF :出现错误,可通过GetLastError得到错误代码
在这里举个例子:
先创建一个全局Event对象g_event:
CEvent g_event;
在程序中可以通过调用CEvent::SetEvent设置事件为有信号状态。
下面是一个线程函数MyThreadPro()
UINT CFlushDlg::MyThreadProc( LPVOID pParam )
{
WaitForSingleObject(g_event,INFINITE);
For(;;)
{
………….
}
return 0;
}
在这个线程函数中只有设置g_event为有信号状态时才执行下面的for循环,因为g_event是全局变量,所以我们可以在别的线程中通过g_event. SetEvent控制这个线程。
还有一种用法就是我们可以通过WaitForSingleObject函数来间隔的执行一个线程函数的函数体
UINT CFlushDlg::MyThreadProc( LPVOID pParam )
{
while(WaitForSingleObject(g_event,MT_INTERVAL)!=WAIT_OBJECT_0)
{
………………
}
return 0;
}
在这个线程函数中可以通过设置MT_INTERVAL来控制这个线程的函数体多久执行一次,当事件为无信号状态时函数体隔MT_INTERVAL执行一次,当设置事件为有信号状态时,线程就执行完毕了。
相关文章推荐
- Windows API一日一练(43)WaitForSingleObject函数
- WaitForSingleObject()函数、WaitForMultipleObject()函数
- c++中WaitForSingleObject函数解析(1)
- WaitForSingleObject()函数、WaitForMultipleObject()函数
- WaitForSingleObject函数用法
- WaitForSingleObject()函数,其第一个参数是一个核心对象(如线程)的 handle
- WaitForSingleObject()在Linux,vxWorks下的等价函数
- 用WaitForSingleObject()函数实现简单的多线程互斥访问
- WaitForSingleObject函数
- Windows API一日一练(43)WaitForSingleObject函数
- WaitForSingleObject()函数、WaitForMultipleObject()函数
- 使用WaitForSingleObject(ha,INFINITE)函数的练习
- WaitForSingleObject函数
- c++中WaitForSingleObject函数解析
- WaitForSingleObject函数
- WaitForSingleObject以及WaitForMultipleObjects 函数
- 在界面线程不能使用Sleep和WaitForSingleObject之类的函数, 使用 MsgWaitForMultipleObjects
- 15.[个人]C++线程入门到进阶(15)----线程函数:WaitForSingleObject
- Windows API一日一练(43)WaitForSingleObject函数
- 在界面线程不能使用Sleep和WaitForSingleObject之类的函数, 使用 MsgWaitForMultipleObjects