TdiBuildConnect
VOID
TdiBuildConnect (
IN PIRP Irp,
IN PDEVICE_OBJECT DevObj,
IN PFILE_OBJECT FileObj,
IN PVOID CompRoutine,
IN PVOID Contxt,
IN PLARGE_INTEGER Time,
IN PTDI_CONNECTION_INFORMATION RequestConnectionInfo,
OUT PTDI_CONNECTION_INFORMATION ReturnConnectionInfo
);
TdiBuildConnect 함수는 로컬 클라이언트가 주소와 연결 엔드포인트를 이미 연관시킨 하부의 트랜스포트로 TDI_CONNECT 리퀘스트를 위해서 내부의 장치 통제 IRP를 설정한다.
매개변수
- Irp
- 더 상위 레벨의 네트웍 컴포넌트에서 발생되거나 TdiBuildInternalDeviceControlIrp 함수를 가지고 할당된 클라이언트 제공 IRP를 가리킨다.
- DevObj
- 하부의 TDI 트랜스포트 드라이버에 의해서 생성된 장치 객체를 가리킨다.
- FileObj
- 연결 엔드포인트를 구현하는 파일 객체를 가리킨다.
- CompRoutine
- 클라이언트 제공 IoCompletion 루틴의 엔트리 포인트를 서술하거나 NULL이다. 클라이언트가 이 매개변수를 NULL로 설정하지 않는다면 주어진 IRP가 완료될 때 I/O 매니저는 이 루틴을 호출한다.
- Contxt
- 클라이언트 결정 컨텍스트를 가리킨다. 이 클라이언트 제공 포인터는 완료된 IRP를 가지고 호출될 때 IoCompletion 루틴으로 전달된다. CompRoutine이 NULL이면 Contxt는 NULL이다.
- Time
- 트랜스포트가 연결 시도를 위해서 사용하는 시스템 관련 타임아웃 간격을 서술하는 변수를 가리킨다. 혹은 NULL일 수 있다.
명확한 타임아웃은 트랜스포트가 이 연결 리퀘스트를 실패하기 전에 연결 시도가 지연을 유지하기 위해서 허락한 현재 시스템 시간과 관계된 음의 100 나노초 간격의 수로 서술되어야한다. 이 포인터가 NULL이면 트랜스포트는 원격지와 연결을 성립하기 위해서 자신의 기본 타임아웃 간격을 사용한다.
- RequestConnectionInfo
- 로컬 클라이언트가 엔드포인트 대 엔드포인트 연결을 리퀘스트중인 원격지의 클라이언트 주소를 서술하는 TDI_CONNECTION_INFORMATION 구조체를 포함하는 호출자 제공 버퍼를 가리킨다.
- ReturnConnectionInfo
- 성립된 연결을 가지고 원격지의 클라이언트 주소를 리턴하는 트랜스포트의 호출자 제공 버퍼를 가리킨다. 또한 이 버퍼는 TDI_CONNECTION_INFORMATION 구조체로써 포맷된다. 로컬 클라이언트가 아웃풋 정보를 요구하지 않거나 하부의 트랜스포트가 그러한 정보를 리턴하지 않는면 이 매개변수는 NULL이어야한다.
주석
TdiBuildConnect 함수는 주어진 IRP의 트랜스포트 I/O 스택 로케이션안에 MajorFunction로써 IRP_MJ_INTERNAL_DEVICE_CONTROL를 설정하고 MinorFunction로써 TDI_CONNECT를 설정한다.
명시된 엔드포인트가 존재하지 않거나 비활성화라면 트랜스포트는 연결 리퀘스트를 실패한다. 명시된 엔드포인트가 로컬 주소와 연관되어있지 않다면 트랜스포트는 연결 리퀘스트를 실패한다.
원격지의 프로세스와 엔드포인트 대 엔드포인트 연결을 성립한 로컬의 클라이언트를 위해서 로컬의 클라이언트는 로컬 주소를 가지고 작업을 안하고 있는 로컬 연결 엔드포인트를 우선적으로 연관시켜야한다. 클라이언트가 하부의 트랜스포트로 TdiBuildAsociateAddress 함수를 가지고 설정한 TDI_ASSOCIATE_ADDRESS 리퀘스트를 성공할 때까지 클라이언트는 원격지로의 연결 시도를 시작할 수 없다.
로컬 클라이언트의 연결 리퀘스트 성공을 위해서 원격지의 클라이언트는 열린 대기 리퀘스트를 가져야한다. 아니면 하부 트랜스포트의 연결 제공으로부터 리시브 통보를 받을 수 있는 등록된 ClientEventConnect 루틴을 가져야한다.
|