Funzione CloseIoRing (ioringapi.h)

Chiude un handle HIORING aperto in precedenza con una chiamata a CreateIoRing.

Sintassi

HRESULT CloseIoRing(
  HIORING ioRing
);

Parametri

ioRing

Handle HIORING da chiudere.

Valore restituito

Restituisce S_OK sull'esito positivo.

Commenti

La chiamata a questa funzione garantisce che le risorse allocate per l'anello di I/O vengano rilasciate. L'handle chiuso non è più valido dopo che la funzione restituisce. È importante notare che la chiusura dell'handle abbandona le operazioni accodate ma non inviate. Tuttavia, le operazioni in anteprima non vengono annullate.

È possibile che le letture da o le scritture nei buffer di memoria vengano comunque eseguite dopo la restituzione di CloseIoRing . Se si vuole assicurarsi che non si verifichino letture o scritture in sospeso, è necessario attendere che i completamento vengano visualizzati nella coda di completamento per tutte le operazioni inviate. È possibile scegliere di annullare le operazioni inviate in precedenza prima di attendere il completamento. In alternativa all'invio di più richieste di annullamento, è possibile chiamare CancelIoEx con l'handle file e NULL per il puntatore sovrapposto per annullare in modo efficace tutte le operazioni in sospeso sull'handle.

Requisiti

Client minimo supportato	Windows Build 22000
Server minimo supportato	Windows Build 22000
Intestazione	ioringapi.h