TdiBuildSetInformation

VOID
   TdiBuildSetInformation (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN UINT SType,
       IN PMDL MdlAddr
      );

TdiBuildSetInformation 함수는 로컬 클라이언트가 주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체를 이미 연 하부의 트랜스포트로 TDI_SET_INFORMATION 리퀘스트를 위해서 내부의 장치 통제 IRP를 설정한다.

매개변수

Irp

TdiBuildInternalDeviceControlIrp 함수를 가지고 할당된 클라이언트 제공 IRP를 가리킨다.

DevObj

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

FileObj

주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체를 가리킨다. 이 파일 객체는 주어진 SType의 적절한 값이어야한다.

CompRoutine

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

Contxt

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

SType

클라이언트가 설정하고자하는 정보의 타입을 서술한다. 이 매개변수는 트랜스포트 정의 혹은 다음의 시스템 정의 값중에 하나일 수 있다:

TDI_QUERY_ADDRESS_INFO

주소에 대해서 제공된 정보를 설정한다. MdlAddr에 맵된 버퍼는 TDI_ADDRESS_INFO 구조체로써 포맷된다.

TDI_QUERY_CONNECTION_INFO

연결 엔드포인트에 대해서 제공된 정보를 설정한다. MdlAddr에 맵된 이 버퍼는 TDI_CONNECTION_INFO 구조체로써 포맷된다.

TDI_QUERY_PROVIDER_INFO

통제 체널에 대해서 제공된 정보를 설정한다. MdlAddr에 맵된 버퍼는 TDI_PROVIDER_INFO 구조체로써 포맷된다. 그러나 클라이언트는 실제로 트랜스포트에 의해서 지원되지 않는 무언가로 트랜스포트의 제공자 정보를 리셋할 수 없다.

TDI_QUERY_PROVIDER_STATISTICS

통제 체널에 대해서 제공된 정보를 설정한다. MdlAddr에 맵된 버퍼는 TDI_PROVIDER_STATISTICS 구조체로써 포맷된다. 그러나 클라이언트는 실제로 트랜스포트에 의해서 유지되지 않는 무언가로 클라이언트 당 상태라기 보다는 전체의 상태인 트랜스포트의 통계를 리셋할 수 없다.

하부의 트랜스포트는 드라이버 개발자의 결정에서 정보 설정 리퀘스트의 추가적인 타입을 지원할 수 있다. 그러한 트랜스포트는 가장 중요한 비트가 설정된 TDI_QUERY_XXX 코드를 정의해야한다.

MdlAddr

설정되는 데이타를 포함하는 클라이언트 제공 버퍼를 매핑하는 MDL을 가리킨다. 이 버퍼의 포맷과 내용은 주어진 SType에 의존한다.

주석

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

클라이언트는 TdiBuildSetInformation 함수로 전달되는 SType에 의존하여 주소, 연결, 통제 채널에 대해서 정보를 설정할 수 있다. 주어진 파일 객체는 주어진 SType 값을 적절히 해야한다. 그렇지 않으면 트랜스포트는 리퀘스트를 실패한다.

또한 하부의 트랜스포트는 MdlAddr에 버퍼안에 부적절한 값을 제공하는 클라이언트를 위해서 리셋을 거절할 수 있다. 예를들면 클라이언트는 하부의 트랜스포트로 하여금 앞선 정보 쿼리 리퀘스트에서 트랜스포트에 의해서 리턴된 TDI_PROVIDER_INFO 구조체의 멤버리셋을 시도하는 정보 설정 리퀘스트를 제시하므로써 트랜스포트 결정의 제한안에서 MaxSendSize 혹은 MaxDatagramSize를 늘이도록 강요할 수 없다.