http://hi.baidu.com/naxiaohe010/blog/item/ee8f54acc29550f6faed5053.html
ResetEvent
這個函數把指定的
事件對象設置為無信號狀態。
BOOL ResetEvent(
HANDLE hEvent
);
參數說明:
hEvent
[in] 指向事件對象的句柄.由 CreateEvent or OpenEvent 函數返回。 這個句柄需要擁有EVENT_MODIFY_STATE 訪問權限.
函數成功,返回非0值,否則返回0值,可以調用GetLastError得到錯誤的詳細信息。
Remarks
一個事件對象一直都保持在無信號狀態,直到顯式調用 SetEvent or PulseEvent 函數把它設置到有信號狀態。 這些無信號的事件對象會阻塞任何在內部調用wait函數的線程。
這個函數用於手動重置的事件對象。手動重置的對象在線程釋放后必須手動置為無信號狀態。 自動重置的事件對象在一個等待它成功的線程釋放后會自動變為無信號狀態。
重置一個無信號的事件對象沒有任何效果。
CreateEvent
函數功能描述 創建或打開一個命名的或無名的事件對象 函數原型
HANDLE CreateEvent(
LPSECURITY_ATTRIBUTES lpEventAttributes, // 安全屬性
BOOL bManualReset, // 復位方式
BOOL bInitialState, // 初始狀態
LPCTSTR lpName // 對象名稱
);
參數 lpEventAttributes:
[輸入]一個指向SECURITY_ATTRIBUTES結構的指針,確定返回的句柄是否可被子進程繼承。如果lpEventAttributes是NULL,此句柄不能被繼承。
Windows NT/2000:lpEventAttributes的結構中的成員為新的事件指定了一個安全符。如果lpEventAttributes是NULL,事件將獲得一個默認的安全符。
bManualReset:
[輸入]指定將事件對象創建成手動復原還是自動復原。如果是TRUE,那么必須用ResetEvent函數來手工將事件的狀態復原到無信號狀態。如果設置為FALSE,當事件被一個等待線程釋放以后,系統將會自動將事件狀態復原為無信號狀態。
bInitialState:
[輸入]指定事件對象的初始狀態。如果為TRUE,初始狀態為有信號狀態;否則為無信號狀態。
lpName:
[輸入]指定事件的對象的名稱,是一個以0結束的字符串指針。名稱的字符格式限定在MAX_PATH之內。名字是對大小寫敏感的。
如果lpName指定的名字,與一個存在的命名的事件對象的名稱相同,函數將請求EVENT_ALL_ACCESS來訪問存在的對象。這時候,由於bManualReset和bInitialState參數已經在創建事件的進程中設置,這兩個參數將被忽略。如果lpEventAttributes是參數不是NULL,它將確定此句柄是否可以被繼承,但是其安全描述符成員將被忽略。
如果lpName為NULL,將創建一個無名的事件對象。
如果lpName的和一個存在的信號、互斥、等待計時器、作業或者是文件映射對象名稱相同,函數將會失敗,在GetLastError函數中將返回ERROR_INVALID_HANDLE。造成這種現象的原因是這些對象共享同一個命名空間。
終端服務(Terminal Services):名稱中可以加入"Global\"或是"Local\"的前綴,這樣可以明確的將對象創建在全局的或事務的命名空間。名稱的其它部分除了反斜杠(\),可以使用任意字符。詳細內容可參考Kernel Object Name Spaces。
Windows 2000:在Windows 2000系統中,沒有終端服務運行,"Global\"和"Local\"前綴將被忽略。名稱的其它部分除了反斜杠(\),可以使用任意字符。
Windows NT 4.0以及早期版本, Windows 95/98:名稱中除了反斜杠(\),可以使用任意字符。
返回值 如果函數調用成功,函數返回事件對象的句柄。如果對於命名的對象,在函數調用前已經被創建,函數將返回存在的事件對象的句柄,而且在GetLastError函數中返回ERROR_ALREADY_EXISTS。
如果函數失敗,函數返回值為NULL,如果需要獲得詳細的錯誤信息,需要調用GetLastError。
備注:
調用CreateEvent函數返回的句柄,該句柄具有EVENT_ALL_ACCESS權限去訪問新的事件對象,同時它可以在任何有此事件對象句柄的函數中使用。
在調用的過程中,所有線程都可以在一個等待函數中指定事件對象句柄。當指定的對象的狀態被置為有信號狀態時,單對象等待函數將返回。
對於多對象等待函數,可以指定為任意或所有指定的對象被置為有信號狀態。當等待函數返回時,等待線程將被釋放去繼續運行。
初始狀態在bInitialState參數中進行設置。使用SetEvent函數將事件對象的狀態置為有信號狀態。使用ResetEvent函數將事件對象的狀態置為無信號狀態。
當一個手動復原的事件對象的狀態被置為有信號狀態時,該對象狀態將一直保持有信號狀態,直至明確調用ResetEvent函數將其置為無符號狀態。
當事件的對象被置為有信號狀態時,任意數量的等待中線程,以及隨后開始等待的線程均會被釋放。
當一個自動復原的事件對象的狀態被置為有信號狀態時,該對象狀態將一直保持有信號狀態,直至一個等待線程被釋放;系統將自動將此函數置為無符號狀態。如果沒有等待線程正在等待,事件對象的狀態將保持有信號狀態。
多個進程可持有同一個事件對象的多個句柄,可以通過使用此對象來實現進程間的同步。下面的對象共享機制是可行的:
·在CreateEvent函數中,lpEventAttributes參數指定句柄可被繼承時,通過CreateProcess函數創建的子進程繼承的事件對象句柄。
·一個進程可以在DuplicateHandle函數中指定事件對象句柄,從而獲得一個復制的句柄,此句柄可以被其它進程使用。
·一個進程可以在OpenEvent或CreateEvent函數中指定一個名字,從而獲得一個有名的事件對象句柄。
使用CloseHandle函數關閉句柄。當進程停止時,系統將自動關閉句柄。當最后一個句柄被關閉后,事件對象將被銷毀。
總結:
一個Event被創建以后,可以用OpenEvent()API來獲得它的Handle,用CloseHandle() 來關閉它,用SetEvent()或PulseEvent()來設置它使其有信號,用ResetEvent() 來使其無信號,用WaitForSingleObject()或WaitForMultipleObjects()來等待其變為有信號。PulseEvent()是一個比較有意思的使用方法,正如這個API的名字,它使一個Event 對象的狀態發生一次脈沖變化,從無信號變成有信號再變成無信號,而整個操作是原子的。對自動復位的Event對象,它僅釋放第一個等到該事件的thread(如果有),而對於人工復位的Event對象,它釋放所有等待的thread。