다음을 통해 공유

CloseIoRing 함수(ioringapi.h)

  • 아티클

CreateIoRing 호출을 사용하여 이전에 연 HIORING 핸들을 닫습니다.

구문

HRESULT CloseIoRing(
  HIORING ioRing
);

매개 변수

ioRing

닫을 HIORING 핸들입니다.

반환 값

성공하면 S_OK를 반환합니다.

설명

이 함수를 호출하면 I/O 링에 할당된 리소스가 해제됩니다. 함수가 반환된 후에는 닫힌 핸들이 더 이상 유효하지 않습니다. 핸들을 닫으면 큐에 대기 중이지만 제출되지 않은 작업이 중단됩니다. 그러나 비행 중인 작업은 취소 되지 않습니다 .

CloseIoRing이 반환된 후에도 메모리 버퍼에서 읽거나 메모리 버퍼에 쓸 수 있습니다. 보류 중인 읽기 또는 쓰기가 발생하지 않도록 하려면 제출된 모든 작업에 대해 완료가 완료 큐에 나타날 때까지 기다려야 합니다. 완료를 기다리기 전에 이전에 제출한 작업을 취소하도록 선택할 수 있습니다. 여러 취소 요청을 제출하는 대신 파일 핸들을 사용하여 CancelIoEx 를 호출하고 겹치는 포인터에 대해 NULL을 호출하여 핸들의 보류 중인 모든 작업을 효과적으로 취소할 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Build 22000
지원되는 최소 서버 Windows Build 22000
머리글 ioringapi.h