共用方式為


StartThreadpoolIo 函式 (threadpoolapiset.h)

通知線程集區,I/O 作業可能針對指定的 I/O 完成對象開始。 背景工作線程會在系結至這個物件的檔案句柄上完成作業之後,呼叫 I/O 完成物件的回呼函式。

語法

void StartThreadpoolIo(
  [in, out] PTP_IO pio
);

參數

[in, out] pio

定義 I/O 完成物件的 TP_IO 結構的指標。 CreateThreadpoolIo 函式會傳回此指標。

傳回值

備註

在系結至 I/O 完成物件的檔案句柄上起始每個異步 I/O 作業之前,您必須先呼叫此函式。 失敗會導致線程集區在完成時忽略 I/O 作業,並會導致記憶體損毀。

如果 I/O 作業失敗,請呼叫 CancelThreadpoolIo 函式來取消此通知。

如果系結至 I/O 完成物件的檔案句柄具有通知模式FILE_SKIP_COMPLETION_PORT_ON_SUCCESS,且異步 I/O 作業會立即傳回成功,則不會呼叫物件的 I/O 完成回呼函式,而且必須取消線程緩衝處理 I/O 通知。 如需詳細資訊,請參閱 CancelThreadpoolIo

若要編譯使用此函式的應用程式,請將_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

線程集區

WaitForThreadpoolIoCallbacks