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.

Valor de retorno

Retorna S_OK com êxito.

Observações

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 que estão na fila, mas não enviadas. No entanto, as operações que estão em voo não são canceladas.

É possível que leituras ou gravações em buffers de memória ainda possam ocorrer após o retorno de CloseIoRing . Se você quiser garantir que não ocorram leituras ou gravações pendentes, aguarde até 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.

Requirements