ClientEventDisconnect
NTSTATUS
ClientEventDisconnect (
IN PVOID TdiEventContext,
IN CONNECTION_CONTEXT ConnectionContext,
IN LONG DisconnectDataLength,
IN PVOID DisconnectData,
IN LONG DisconnectInformationLength,
IN PVOID DisconnectInformation,
IN ULONG DisconnectFlags
);
ClientEventDisconnect 함수는 원격지로부터 들어오는 연결해제 통보에 대한 응답으로 하부의 TDI 트랜스포트가 호출하는 이벤트 핸들러이다.
매개변수
- TdiEventContext
- ClientEventDisconnect 함수가 하부의 트랜스포트를 가지고 등록될 때 TdiBuildSetEventHandler 함수를 가지고 설정된 IRP안에 제공된 클라이언트 제공 컨텍스트를 가리킨다.
- ConnectionContext
- 이 연결 엔드포인트에 대해서 클라이언트의 컨텍스트 지역을 가리킨다. ClientEventConnect 핸들러가 원격지로부터 연결 제공을 승인했을 때나 ZwCreateFile 함수를 가지고 연결 엔드포인트를 열었을 때 클라이언트는 전에 하부의 트랜스포트로 이 값을 제공했다.
- DisconnectDataLength
- DisconnectData에 버퍼의 바이트 사이즈를 서술한다. 0은 원격지로부터 전송된 연결 해제 데이타가 없음을 의미한다.
- DisconnectData
- 하부의 트랜스포트에 의해서 원격지로부터 리시브된 연결해제 데이타를 포함하는 버퍼를 가리킨다. DisconnectDataLength가 0이면 이 매개변수는 NULL이다.
- DisconnectInformationLength
- DisconnectInformation에 버퍼의 바이트 사이즈를 서술한다. 0은 원격지로부터 전송된 추가적인 연결해제 데이타가 없음을 인디케이트한다.
- DisconnectInformation
- 어떤 추가적인 트랜스포트 특정 연결 해제 정보를 포함하는 버퍼를 가리킨다. DisconnectInformationLength가 0이면 이 포인터는 NULL이다.
- DisconnectFlags
- 0 혹은 다음 플래그 중에 하나로 연결해제 연산의 특징을 서술한다:
- TDI_DISCONNECT_ABORT
- 트랜스포트는 연결상에서 지연된 연산의 완료없이 즉시 엔드포인트 대 엔드포인트 연결을 닫는다. 사실상 이 플래그는 0의 DisconnectFlags와 같다.
- TDI_DISCONNECT_RELEASE
- 트랜스포트는 원격지와 함께 통제된 연결해제 연산을 진행중이다.
리턴값
ClientEventDisconnect 함수는 STATUS_SUCCESS를 리턴할 수 있다.
주석
ClientEventDisconnect 함수로의 호출은 그들의 성립된 엔드포인트 대 엔드포인트 연결을 원격지가 닫고 있다고 로컬 클라이언트에게 알린다. 입력 DisconnectFlags에 의존하여 연결해제는 통제될 수 있거나 그렇지 않을 수 있다. ClientEventDisconnect 함수는 TDI 드라이버가 엔드포인트 대 엔드포인트 연결에서 호출하는 마지막 이벤트 핸들러이다.
TDI_DISCONNECT_RELEASE가 DisconnectFlags에 설정된다면 트랜스포트는 통제된 연결해제를 협력한다.(세부사항은 TDI_DISCONNECT를 봐라.)
ClientEventDisconnect 함수로의 호출은 앤드포인트 대 엔드포인트 동작이 중지됐거나 그 클라이언트에 의해서 열린 연결 엔드포인트에서 끝나고 있는 중이다라고 로컬 클라이언트에게 알린다. 그러나 연결 엔드포인트는 엔드포인트 대 엔드포인트 연결이 파괴된 후에도 여전히 유효하다. 로컬의 클라이언트는 ClientEventDisconnect 함수가 통제를 리턴한 후에 순차적인 연산에서 열린 연결 엔드포인트를 재사용할 수 있다.
ClientEventDisconnect 함수는 IRQL DISPATCH_LEVEL에서 연산을 수행할 능력이 있어야한다.
|