TdiDispatchClose

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

TdiDispatchClose 함수는 주소, 연결 엔드포인트, 혹은 텅제 채널을 닫는다.

매개변수

DeviceObject

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

Irp

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

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

IoStatus.Status

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

IrpSp->MajorFunction

IRP_MJ_CLOSE를 서술한다. 트랜스포트가 닫기 리퀘스트만을 처리하는 TdiDispatchClose 루틴을 익스포트한다면 이 멤버를 무시할 수 있다.

IrpSp->FileObject

주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체를 서술한다. 트랜스포트 드라이버는 TdiDispatchCleanup 함수가 전에 해제하지 않은 유지되는 드라이버 할당 상태로 접근하기 위해서 이 파일 객체의 FsContext와 가능하다면 FsContext2의 값을 사용한다.

리턴값

닫히는 파일 객체를 위해서 주어진 주소, 연결 엔드포인트, 통제 채널을 트랙하기 위해 할당된 자원을 해제하듯이 TdiDispatchClose 함수는 드라이버 결정 연산이 수행됐을 때 STATUS_SUCCESS를 리턴한다.

주석

주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체의 핸들에 대한 마지막 참조를 I/O 매니저가 해제할 때 TdiDispatchClose 함수가 실행된다. 파일 핸들에 대한 이 마지막 참조가 해제됐을 때 파일 객체가 해제된다.

주소, 연결 엔드포인트, 통제 채널을 구현하는 열린 파일 객체에 대한 마지막 핸들을 I/O 매니저가 닫을 때 I/O 매니저는 TdiDispatchCleanup 함수를 호출한다. 바꾸어 말하면 특정 파일 객체에 대한 IRP_MJ_CLOSE 리퀘스트를 제출하기 전에 I/O 매니저는 항상 트랜스포트로 IRP_MJ_CLEANUP 리퀘스트를 제출한다.

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

TdiDispatchCleanup 함수에 의해서 모든 자원이 해제되지 않는다면 TdiDispatchClose 함수는 주어진 파일 객체와 연관된 드라이버 할당 자원을 해제해야하는 책임이 있다.

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