共用方式為


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

另請參閱

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

線程集區