WaitForThreadpoolIoCallbacks 函式 (threadpoolapiset.h)

發行項
03/05/2024

等候未完成的 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