Função CloseIoRing (ioringapi.h)

Fecha um identificador HIORING que foi aberto anteriormente com uma chamada para CreateIoRing.

Sintaxe

HRESULT CloseIoRing(
  HIORING ioRing
);

Parâmetros

ioRing

O identificador HIORING a ser fechado.

Retornar valor

Retornará S_OK se houver êxito.

Comentários

Chamar essa função garante que os recursos alocados para o anel de E/S sejam liberados. O identificador fechado não é mais válido após o retorno da função. É importante observar que fechar o identificador abandona as operações enfileiradas, mas não enviadas. No entanto, as operações que estão em voo não são canceladas.

É possível que as leituras ou gravações em buffers de memória ainda possam ocorrer após o retorno de CloseIoRing . Se quiser garantir que não ocorram leituras ou gravações pendentes, você deverá aguardar que as conclusões apareçam na fila de conclusão para todas as operações enviadas. Você pode optar por cancelar as operações enviadas anteriormente antes de aguardar suas conclusões. Como alternativa ao envio de várias solicitações de cancelamento, você pode chamar CancelIoEx com o identificador de arquivo e NULL para que o ponteiro sobreposto cancele efetivamente todas as operações pendentes no identificador.

Requisitos