Función CloseIoRing (ioringapi.h)

Cierra un identificador HIORING que se abrió anteriormente con una llamada a CreateIoRing.

Sintaxis

HRESULT CloseIoRing(
  HIORING ioRing
);

Parámetros

ioRing

Identificador HIORING que se va a cerrar.

Valor devuelto

Devuelve S_OK si se realiza correctamente.

Comentarios

Llamar a esta función garantiza que se liberen los recursos asignados para el anillo de E/S. El identificador cerrado ya no es válido después de que la función vuelva. Es importante tener en cuenta que cerrar el identificador abandona las operaciones que se ponen en cola pero no se envían. Sin embargo, las operaciones que están en curso no se cancelan.

Es posible que las lecturas de o escrituras en búferes de memoria todavía se produzcan después de que CloseIoRing devuelva. Si desea asegurarse de que no se produzcan lecturas o escrituras pendientes, debe esperar a que las finalizaciones aparezcan en la cola de finalización para todas las operaciones enviadas. Puede optar por cancelar las operaciones enviadas anteriormente antes de esperar a que se completen. Como alternativa al envío de varias solicitudes de cancelación, puede llamar a CancelIoEx con el identificador de archivo y NULL para que el puntero superpuesto cancele eficazmente todas las operaciones pendientes en el identificador.

Requisitos