Funzione StartThreadpoolIo (threadpoolapiset.h)

Articolo
03/02/2024

Notifica al pool di thread che le operazioni di I/O potrebbero iniziare per l'oggetto di completamento di I/O specificato. Un thread di lavoro chiama la funzione di callback dell'oggetto di completamento I/O al termine dell'operazione sull'handle di file associato a questo oggetto.

Sintassi

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

Parametri

[in, out] pio

Puntatore a una struttura TP_IO che definisce l'oggetto di completamento I/O. La funzione CreateThreadpoolIo restituisce questo puntatore.

Valore restituito

nessuno

Osservazioni

È necessario chiamare questa funzione prima di avviare ogni operazione di I/O asincrona sull'handle di file associato all'oggetto di completamento di I/O. In caso contrario, il pool di thread ignorerà un'operazione di I/O al termine e causerà il danneggiamento della memoria.

Se l'operazione di I/O non riesce, chiamare la funzione CancelThreadpoolIo per annullare questa notifica.

Se l'handle di file associato all'oggetto di completamento di I/O ha la modalità di notifica FILE_SKIP_COMPLETION_PORT_ON_SUCCESS e un'operazione di I/O asincrona restituisce immediatamente esito positivo, la funzione di callback di completamento I/O dell'oggetto non viene chiamata e le notifiche di I/O del pool di thread 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 (include Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll