TdiBuildAssociateAddress

VOID
   TdiBuildAssociateAddress (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN HANDLE AddrHandle
      );

TdiBuildAssociateAddress 함수는 로컬 클라이언트가 주소와 연결 엔드포인트를 이미 연 하부의 트랜스포트로 TDI_ASSOCIATE_ADDRESS 리퀘스트를 위해서 내부 장치 통제 IRP를 설정한다.

매개변수

Irp

더 상위 레벨의 네트웍 컴포넌트에서 발생되거나 TdiBuildInternalDeviceControlIrp 함수를 가지고 할당된 클라이언트 제공 IRP를 가리킨다.

DevObj

하부의 TDI 트랜스포트 드라이버에 의해서 생성된 장치 객체를 가리킨다.

FileObj

연결 엔드포인트를 구현하는 파일 객체를 가리킨다.

CompRoutine

클라이언트 제공 IoCompletion 루틴의 엔트리 포인트를 서술하거나 NULL이다. 클라이언트가 이 매개변수를 NULL로 설정하지 않는다면 주어진 IRP가 완료될 때 I/O 매니저는 이 루틴을 호출한다.

Contxt

클라이언트 결정 컨텍스트를 가리킨다. 이 클라이언트 제공 포인터는 완료된 IRP를 가지고 호출될 때 IoCompletion 루틴으로 전달된다. CompRoutine이 NULL이면 Contxt는 NULL이다.

AddrHandle

로컬 주소를 구현하는 파일 객체에 대한 핸들을 서술한다.

주석

TdiBuildAssociateAddress 함수는 주어진 IRP의 트랜스포트 I/O 스택 로케이션안에 MajorFunction로써 IRP_MJ_INTERNAL_DEVICE_CONTROL을 설정하고 MinorFunction로써 TDI_ASSOCIATE_ADDRESS를 설정한다.

커널 모드 클라이언트는 TdiBuildAssociateAddress 함수를 호출하기 전에 ZwCreateFile 함수로의 성공적인 호출을 가지고 주소와 연결 엔드포인트를 열어야한다. 클라이언트는 임의로 TdiBuildAccept 함수를 가지고 설정된 것에 의해서 뒤따르는 TdiBuildListen 함수나 TdiBuildConnect 함수를 가지고 설정된 리퀘스트를 가지고 트랜스포트 드라이버에서 원격지로의 연결을 하기전에 주소를 연관시키는 리퀘스트를 해야한다.

그러나 주소를 연관시키는 리퀘스트를 하기전에 TdiBuildQueryInformation와 TdiBuildSetInformation 함수를 가지고 설정된 하나이상의 리퀘스트를 가지고 열린 주소 혹은 연결에 대해서 클라이언트는 정보를 얻거나 설정할 수 있다.

클라이언트가 주소를 가지고 연결 엔드포인트를 연관지은 후에 클라이언트는 한가지 예외를 가지고 연관된 연결에서만 트랜스포트로의 어떤 다른 TDI_XXX 리퀘스트를 할 수 있다: 클라이언트가 트랜스포트로 성공적인 TDI_DISASSOCIATE_ADDRESS 리퀘스트를 할 때까지 클라이언트는 특정 엔드포인트를 위해서 다시 TDI_ASSOCIATE_ADDRESS 리퀘스트를 할 수 없다.