WaitForThreadpoolIoCallbacks 函式 (threadpoolapiset.h)
等候未完成的 I/O 完成回呼完成,並選擇性地取消尚未開始執行的擱置回呼。
語法
void WaitForThreadpoolIoCallbacks(
[in, out] PTP_IO pio,
[in] BOOL fCancelPendingCallbacks
);
參數
[in, out] pio
定義 I/O 完成物件的 TP_IO 結構的指標。 CreateThreadpoolIo 函式會傳回此指標。
[in] fCancelPendingCallbacks
指出是否取消尚未開始執行的佇列回呼。
傳回值
無
備註
當 fCancelPendingCallbacks 設定為 TRUE 時,只會取消佇列回呼。 擱置的 I/O 要求不會取消。 因此,呼叫端應該呼叫重迭結構的 GetOverlappedResult,以在釋放結構之前檢查 I/O 作業是否已完成。 或者,將 fCancelPendingCallbacks 設定為 FALSE,並讓相關聯的 I/O 完成回呼釋放 重疊 結構。 請小心不要釋放 重疊 結構,而 I/O 要求仍在擱置中;使用 GetOverlappedResult 來判斷 I/O 作業的狀態,並等候作業完成。 CancelIoEx 函式可以選擇性地用來取消未處理的 I/O 要求,這可能會縮短等候時間。 如需詳細資訊,請參閱 取消擱置 I/O 作業。
若要編譯使用此函式的應用程式,請將_WIN32_WINNT定義為0x0600或更高版本。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | threadpoolapiset.h (Windows 7、Windows Server 2008 Windows Server 2008 R2) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |