ClientEventConnect

NTSTATUS
   ClientEventConnect (
       IN PVOID TdiEventContext,
       IN LONG RemoteAddressLength,
       IN PVOID RemoteAddress,
       IN LONG UserDataLength,
       IN PVOID UserData,
       IN LONG OptionsLength,
       IN PVOID Options,
       OUT CONNECTION_CONTEXT *ConnectionContext,
       OUT PIRP *AcceptIrp
      );

ClientEventConnect 함수는 원격지로부터 들어오는 엔드포인트 대 엔드포인트 연결 제공에 대한 응답으로 TDI 드라이버가 호출하는 이벤트 핸들러이다.

매개변수

TdiEventContext

ClientEventConnect 함수가 하부의 트랜스포트를 가지고 등록될 때 TdiBuildSetEventHandler 함수를 가지고 설정된 IRP안에 제공된 클라이언트 제공 컨텍스트를 가리킨다.

RemoteAddressLength

RemoteAddress에 버퍼의 바이트 사이즈를 서술한다.

RemoteAddress

이 연결을 제공한 원격지 클라이언트의 트랜스포트 주소를 포함하는 버퍼를 가리킨다.

UserDataLength

UserData에 버퍼의 바이트 사이즈를 서술한다. 0은 데이타가 사용될 수 없음을 인디케이트하거나 하부의 트랜스포트가 제공된 연결에서 데이타 보내기를 지원하지 않는다는 것을 인디케이트한다. 이 매개변수가 0이면 UserData는 NULL이다.

UserData

연결 제공을 가지고 원격지의 클라이언트에 의해서 제공된 연결 데이타를 포함하는 버퍼를 가리킨다. UserDataLength가 0이면 이 매개변수는 NULL이다.

OptionsLength

Options에 버퍼의 바이트 사이즈를 서술한다. 0은 옵션 문자열이 없음을 의미한다. 이 매개변수가 0이면 Options는 NULL이다.

Options

트랜스포트 특정 포멧에서 연결에 대해서 옵션을 포함하는 버퍼를 가리킨다. OptionsLength가 0이면 이 매개변수는 NULL이다.

ConnectionContext

이 연결 엔드포인트에 대해서 클라이언트 결정 상태를 유지하는 클라이언트 컨텍스트 지역의 포인터를 리턴하는 ClientEventConnect 함수의 호출자 제공 변수를 가리킨다. 보통 명시된 주소는 클라이언트가 로컬 연결 엔드포인트를 열기 위해서 ZwCreateFile 함수를 호출했을 때 EaBuffer에 값을 위해서 설정한 값과 같다. ClientEventConnect 함수가 제공된 연결을 거절했다면 리턴하는 값은 NULL이다.

AcceptIrp

TdiBuildAccept 함수를 가지고 ClientEventConnect 함수에 의해서 설정된 IRP에 대한 포인터를 리턴하는 ClientEventConnect 함수의 호출자 제공 변수를 가리킨다. 트랜스포트가 정상적인 승인 리퀘스트를 할 때 제공된다면 트랜스포트는 이 IRP를 완료한다. ClientEventConnect 함수가 연결 제공을 거절한다면 이 매개변수는 NULL이다.

리턴값

ClientEventConnect 함수는 다음중 하나를 리턴할 수 있다:

STATUS_MORE_PROCESSING_REQUIRED

ClientEventConnect 함수는 제공된 연결을 받아들이는 중이고 AcceptIrp에 승인 리퀘스트를 제공했다.

몇몇 트랜스포트는 ClientEventConnect 함수가 이 리턴값외에 다른 무언가를 리턴한다면 연결 제공이 거절된다고 가정한다.

STATUS_CONNECTION_REFUSED

ClientEventConnect 함수는 제공된 연결을 거절하는 중이다.

STATUS_INSUFFICIENT_RESOURCES

ClientEventConnect 함수는 제공된 연결을 받아들일 만한 충분한 자원을 할당하지 않았다. 트랜스포트는 원격지오 거절을 보낼 것이다.

주석

이 호출은 원격지의 프로세스로부터 들어오는 연결 제공을 로컬의 클라이언트에게 알린다. 로컬의 ClientEventConnect 핸들러는 원격지의 클라이언트를 확인하는 트랜스포트 제공 주소 정보를 검사하고 이 연결 제공을 승인할 것인지를 결정하기 위해서 UserData와 Options에 데이타를 검사한다.

제공된 엔드포인트 대 엔드포인트 연결을 승인하기 위해서 ClientEventConnect 함수는 TDI_ACCEPT 리퀘스트와 함께 ConnectionContext에 버퍼를 설정해야한다. 그리고나서 STATUS_MORE_PROCESSING_REQUIRED를 리턴해야한다. 로컬 트랜스포트는 승인 IRP안으로 클라이언트가 제공한 어떤 연결 데이타를 전송한다는 승인을 원격지에게 알린다. 그리고 정상적으로 TDI_ACCEPT 리퀘스트를 완료한다.

ClientEventConnect 햄들러가 호출되기 전에 클라이언트는 연결 제공을 승인하기 위해서 사용할 IRP를 미리 할당해야한다. 일반적으로 어떤 클라이언트는 IRQL DISPATCH_LEVEL에서 실행되는 동안에 하부의 트랜스포트로 순차적으로 제시되는 TDI_XXX IOCTL 리퀘스트를 위해서 몇몇 IRP를 미리 할당해야한다. TdiBuildInternalDeviceControlIrp 함수로의 클라이언트 호출은 IRQL PASSIVE_LEVEL에서 발생할 수 있다.

ClientEventConnect 함수가 STATUS_MORE_PROCESSING_REQUIRED를 가지고 통제를 리턴할 때 하부의 트랜스포트는 로컬 클라이언트로 돌아가는 주어진 승인 IRP를 완료하기 전에 클라이언트의 등록된 ClientEvent(Chained)Receive(Expedited) 핸들러에 대한 엔드포인트 대 엔드포인트 연결 상에서 들어오는 리시브들을 인디케이트할 수 있다. 클라이언트는 원격지로부터 엔드포인트 대 엔드포인트 연결 제공의 승인에 동의하자마자 리시브된 데이타를 받아들일 준비를 해야한다.

제공된 엔드포인트 대 엔드포인트 연결을 거절하기 위해서 ClientEventConnect 함수는 단지 STATUS_CONNECTION_REFUSED를 리턴할 수 있다. 이 리턴 상태에 대해서 로컬의 트랜스포트는 연결 제공이 거절된 원격지의 트랜스포트에게 알린다.

클라이언트가 연결 제공을 받아들이기 위해서 충분한 자원을 할당하지 않거나 가지고 있지 않다면 ClientEventConnect 함수는 STATUS_INSUFFICIENT_RESOURCES를 리턴한다. 이 리턴 상태에 대해서 TDI 트랜스포트는 원격지 상에서 대응하는 트랜스포트로의 원격지 클라이언트의 연결 제공 거절을 보내거나 아니면 단순히 연결 제공을 드랍한다.

ClientEventConnect 함수는 IRQL DISPATCH_LEVEL에서 연산을 수행할 능력이 있어야한다.