Funzione StartThreadpoolIo (threadpoolapiset.h)
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 |