Funzione CreateThreadpoolIo (threadpoolapiset.h)

Articolo
03/02/2024

Crea un nuovo oggetto di completamento di I/O.

Sintassi

PTP_IO CreateThreadpoolIo(
  [in]                HANDLE                fl,
  [in]                PTP_WIN32_IO_CALLBACK pfnio,
  [in, out, optional] PVOID                 pv,
  [in, optional]      PTP_CALLBACK_ENVIRON  pcbe
);

Parametri

[in] fl

Handle di file da associare a questo oggetto di completamento di I/O.

[in] pfnio

La funzione di callback da chiamare ogni volta che un'operazione di I/O sovrapposta viene completata nel file. Per informazioni dettagliate, vedere IoCompletionCallback.

[in, out, optional] pv

Dati definiti dall'applicazione facoltativi da passare alla funzione di callback.

[in, optional] pcbe

Puntatore a una struttura TP_CALLBACK_ENVIRON che definisce l'ambiente in cui eseguire il callback. Usare la funzione InitializeThreadpoolEnvironment per inizializzare la struttura prima di chiamare questa funzione.

Se questo parametro è NULL, il callback viene eseguito nell'ambiente di callback predefinito. Per altre informazioni, vedere InitializeThreadpoolEnvironment.

Valore restituito

Se la funzione ha esito positivo, restituisce un puntatore a una struttura TP_IO che definisce l'oggetto I/O. Le applicazioni non modificano i membri di questa struttura.

Se la funzione ha esito negativo, restituisce NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Per iniziare a ricevere callback di completamento di I/O sovrapposti, chiamare la funzione StartThreadpoolIo .

Se l'handle di file associato all'oggetto di completamento I/O ha la modalità di notifica FILE_SKIP_COMPLETION_PORT_ON_SUCCESS e un'operazione di I/O asincrona restituisce immediatamente con esito positivo, la funzione di callback di I/O di completamento di I/O non viene chiamata e le notifiche di I/O di threadpool devono essere annullate. Per altre informazioni, vedere CancelThreadpoolIo.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	threadpoolapiset.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll