TdiDispatchCleanup

NTSTATUS
   TdiDispatchCleanup (
        IN PDEVICE_OBJECT DeviceObject,
        IN PIRP Irp
      );

TdiDispatchCleanup 함수는 닫히려고 하는 주소, 연결 엔드포인트, 혹은 통제 채널을 위한 특정 IRP를 완료한다.

매개변수

DeviceObject
TDI 트랜스포트에 의해서 생성된 장치 객체를 가리킨다.

Irp
트랜스포트 드라이버의 I/O 스택 로케이션에 MajorFunctionCode로써 설정된 IRP_MJ_CLEANUP을 가진 IRP를 가리킨다.

IrpSp 로써 다음의 리스트에 보여지는 IRP에 자신의 스택 로케이션에 대한 포인터를 얻기 위해서 주어진 IRP를 가지고 트랜스포트는 IoGetCurrentIrpStackLocation 함수를 호출한다. TdiDispatchCleanup 함수는 처리되는 클린업 리퀘스트에 다음의 IRP 멤버로 설정되는 정보를 사용할 수 있다:

IoStatus.Status
클린업 연산의 마지막 상태를 서술해라. 트랜스포트는 이 멤버를 TdiDispatchCleanup 함수에 의해서 리턴되는 같은 값으로 설정한다.(IoStatus.Information는 0 으로 설정된다.)

IrpSp->MajorFunction
IRP_MJ_CLEANUP을 서술한다. 트랜스포트가 클린업 리퀘스트만을 다루는 TdiDispatchCleanup 루틴을 익스포트한다면 트랜스포틑 이 멤버를 무시할 수 있다.

IrpSp->FileObject
주소, 연결 엔드포인트, 혹은 통제 채널을 구현하는 열린 파일 객체를 가리킨다. 파일 객체가 클라이언트에 의해서 열릴 때 TdiDispatchCreate 함수가 주소, 연결 엔드포인트, 통제 채널을 위해서 근본적으로 설정한 상태를 접근하기 위해서 트랜스포트 드라이버는 이 파일 객체에 FsContext 값을 사용한다. 가능하다면 FsContext2의 값도 사용한다.

리턴값

클린업 연산이 행해져서 트랜스포트가 주소, 연결 엔드포인트, 혹은 통제 채널을 위해서 큐를 유지하는 어떤 지연된 IRP를 완료했을 때 TdiDispatchCleanup 함수는 STATUS_SUCCESS를 리턴한다.

주석

I/O 매니저가 주소, 연결 엔드포인트, 통제 채널을 구현하는 열린 파일 객체에 대한 마지막 핸들을 닫을 때 TdiDispatchCleanup 함수가 실행된다. TdiDispatchCleanup 함수는 열린 파일 객체를 참조하는 트랜스포트가 현재 유지하고 있는 IRP의 완료에 대한 책임이 있다.

I/O 매니저가 그러한 파일 객체 핸들로의 마지막 참조를 제거할 때 I/O 매니저는 TdiDispatchClose 함수를 호출한다. 바꾸어 말하면 I/O 매니저는 특정 파일 객체를 위한 IRP_MJ_CLOSE 리퀘스트를 제출하기 전에 트랜스포트로 IRP_MJ_CLEANUP 리퀘스트를 항상 제출한다.

주소, 연결 엔드포인트, 통제 채널을 위한 클린업은 원래 동기적인 연산이다. TdiDispatchCleanup 함수는 특정 클린업 작업을 처리하기 위해서 내부의 드라이버 함수를 기다리는 것을 방해할 수 있지만 TdiDispatchCleanup 함수는 입력 클린업 IRP 자체를 완료해야한다.

주소를 구현하는 파일 객체에 대한 핸들을 닫는 것은 전에 클라이언트에 의해서 열린 트랜스포트 주소의 사용을 취소한다. 주소를 구현하는 FileObject를 위한 클린업 리퀘스트를 받을 때 트랜스포트는 다음을 한다:

  • 주소로 지시되는 어떤 지연된 리퀘스트를 완료해라.

  • 주소 상에서 등록된 클라이언트 이벤트 핸들러를 등록해제해라.

  • 트랜스포트가 TdiDispatchClose 함수로 자원해제를 연기하지 않는다면 주소를 트랙하기 위해서 설정된 드라이버 할당 상태를 선택적으로 해제해라.
TdiDispatchCleanup 함수로부터의 리턴에서 트랜스포트는 주소를 위해서 큐에 저장된 어떤 특정 IRP도 유지하지 않지만 드라이버는 특히 TdiDispatchCleanup 함수가 파일 객체안에 FsContext와 FsContext2에 드라이버 할당 컨텍스트를 해제하지 않는다면 그 주소를 구현하는 파일 객체에 대한 자신의 두드러진 참조를 가질 수 있다.

클라이언트가 전에 관련된 주소로부터 연결을 끊는 리퀘스트를 만들지 않는다 할지라도 TdiDispatchCleanup 함수는 연결 엔드포인트를 닫기 위해서 호출될 수 있다. FileObject가 연결 엔드포인트를 구현하기 위해서 클린업 리퀘스트를 받을 때 트랜스포트는 다음을 한다:

  • 연결 엔드포인트와 연관된 활성화된 연결을 취소해라.

  • 필요하다면 연결 엔드포인트와 연관된 주소 사이에서 분열의 결과를 시뮬레이트해라.

  • 연결과 연관된 주소에서 등록된 클라이언트 이벤트를 등록해제해라.

  • 연결로 지시되는 지연된 리퀘스트를 완료해라.

  • 트랜스포트가 TdiDispatchClose 함수로 자원해제를 지연하지 않는다면 연결을 트랙하기 위해서 설정된 드라이버 할당 상태를 선택적으로 해제해라.

TdiDispatchCleanup 함수로부터의 리턴에서 트랜스포트는 연결 엔드포인트를 위해서 큐에 저장된 어떤 특정 보내기 혹은 받기를 유지하지 않지만 드라이버는 특히 TdiDispatchCleanup 함수가 파일 객체 안에 FsContext와 FsContext2에 드라이버 할당 컨텍스트를 해제하지 않는다면 그 연결을 구현하는 파일 객체에 대한 자신의 두드러진 참조를 가질 수 있다.

통제 채널을 구현하는 FileObject를 위해서 클린업 리퀘스트를 받을 때 트랜스포트는 통제 채널에 대한 특정 리퀘스트를 완료한다. 그러한 리퀘스트는 TDI 드라이버에서 열린 주소와 연결 엔드포인트에는 아무런 영향도 주지 않는다.

트랜스포트가 클린업 리퀘스트를 받았을 때 지연된 IRP를 어떻게 처리하는지는 드라이버가 결정한다. 일반적으로 트랜스포트는 I/O 상태 블럭에 STATUS_CANCELLED를 설정하고 그리고나서 각각의 지연된 IRP를 가지고 IoCompleteRequest 함수를 호출한다. 선택적으로 트랜스포트는 지연된 연산을 완료하고 리퀘스트된 연산이 행해졌을 때 각각의 IRP를 완료한다: 즉, 지연된 리시브와 주소 혹은 연결 엔드포인트에 대한 지연된 전송을 위해 다음 하위 드라이버에 의해서 할당된 자원을 리턴하고 대응하는 IRP를 완료하기 전에 통제 채널에 대한 현재 통계의 모음을 수집해라.

주어진 트랜스포트가 닫히는 주소, 연결 엔드포인트, 통제 채널에 대한 지연된 IRP를 무슨 방법으로든지 처리한다면 TdiDispatchCleanup 함수는 클린업 IRP를 완료할 수 없고 주어진 클린업 IRP에서 FileObject를 참조하는 두드러진 IRP가 없을 때까지 통제를 리턴한다.

기본적으로 TdiDispatchCleanup 함수는 IRQL PASSIVE_LEVEL에서 실행된다.