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

Vedere anche

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

Pool di thread

WaitForThreadpoolIoCallbacks