Funzione WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Attende il completamento dei callback di completamento di I/O in sospeso e, facoltativamente, annulla i callback in sospeso che non sono ancora stati avviati per l'esecuzione.

Sintassi

void WaitForThreadpoolIoCallbacks(
  [in, out] PTP_IO pio,
  [in]      BOOL   fCancelPendingCallbacks
);

Parametri

[in, out] pio

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

[in] fCancelPendingCallbacks

Indica se annullare i callback in coda che non sono ancora stati avviati per l'esecuzione.

Valore restituito

nessuno

Osservazioni

Quando fCancelPendingCallbacks è impostato su TRUE, vengono annullati solo i callback in coda. Le richieste di I/O in sospeso non vengono annullate. Pertanto, il chiamante deve chiamare GetOverlappedResult per la struttura OVERLAPPED per verificare se l'operazione di I/O è stata completata prima di liberare la struttura. In alternativa, impostare fCancelPendingCallbacks su FALSE e avere il callback di completamento I/O associato liberare la struttura OVERLAPPED . Prestare attenzione a non liberare la struttura OVERLAPPED mentre le richieste di I/O sono ancora in sospeso; usare GetOverlappedResult per determinare lo stato dell'operazione di I/O e attendere il completamento dell'operazione. La funzione CancelIoEx può essere usata per prima cosa per annullare le richieste di I/O in sospeso, riducendo potenzialmente l'attesa. Per altre informazioni, vedere Annullamento di operazioni di I/O in sospeso.

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

Requisiti

Vedere anche

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Pool di thread