Funzione WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Articolo
03/02/2024

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

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

Vedere anche

Condividi tramite