TDI_SET_INFORMATION

커널 모드 클라이언트가 TDI_SET_INFORMATION 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버로 하여금 특정 주소, 연결, 통제 채널에서 클라이언트 특정 타입의 정보를 설정하도록 요구한다.

IRP

IrpSp로써 다음의 리스트에 보여지는 IRP안에 자신의 I/O 스택 로케이션에 대한 포인터를 얻기 위해서 주어진 Irp를 가지고 트랜스포트는 IoGetCurrentIrpStackLocation 함수를 호출할 수 있다. IRP에 대한 포인터는 Irp로써 다음의 리스트에 보여진다. 이 리퀘스트와 연관된 IRP 멤버는 다음과 같다:

Irp->IoStatus.Status

셋 정보 리퀘스트의 마지막 상태를 서술한다. 트랜스포트는 다음중 하나로 IRP를 완료하기 전에 이 멤버를 설정한다:

STATUS_SUCCESS
STATUS_INVALID_ADDRESS_COMPONENT
STATUS_INVALID_CONNECTION
STATUS_INVALID_DEVICE_REQUEST
STATUS_INVALID_PARAMETER
STATUS_INSUFFICIENT_RESOURCES
STATUS_NOT_IMPLEMENTED

Irp->IoStatus.Information

드라이버가 Irp->MdlAddress에 맵된 버퍼에서 사용한 클라이언트 제공 데이타의 바이트 수를 서술한다.

IrpSp->MajorFunction

IRP_MJ_INTERNAL_DEVICE_CONTROL을 서술한다. 트랜스포트는 TDI_XXX만을 다루는 TdiDispatchInternalDeviceControl 루틴을 익스포트한다면 이 멤버를 무시할 수 있다.

IrpSp->MinorFunction

TDI_SET_INFORMATION을 서술한다.

IrpSp->FileObject

로컬의 주소, 연결 엔드포인트, 통제 채널을 구현하는 열린 파일 객체를 서술한다. 트랜스포트는 이 주소, 연결 엔드포인트, 통제 채널에 대해서 유지하는 상태를 접근하기 위해서 FsContext와 가능하다면 FsContext2 필드를 사용한다.

IrpSp->Parameters

다음과 같이 정의되는 TDI_REQUEST_KERNEL_SET_INFORMATION 구조체를 가리킨다:


struct _TDI_REQUEST_KERNEL_SET_INFO {

    LONG SetType;

    PTDI_CONNECTION_INFORMATION RequestConnectionInformation;

} TDI_REQUEST_KERNEL_SET_INFORMATION, *PTDI_REQUEST_KERNEL_SET_INFORMATION;

트랜스포트는다음과 같이 이 구조체의 멤버를 사용한다:

SetType: 수행하는 셋 연산의 타입을 서술한다(주석을 봐라).
RequestConnectionInformation: 주어진 파일 객체가 연결을 구현한다면 입력 연결 정보를 포함하는 TDI_CONNECTION_INFORMATION 구조체를 가리킨다. 그렇지 않으면 이 멤버는 NULL이다.

Irp->MdlAddress

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

주석

클라이언트가 이 IRP를 설정하기 위해서 TdiBuildSetInformation 함수를 호출할 때 클라이언트는 하고자하는 셋 연산의 타입을 서술해야하고 적절한 데이타를 포함하는 버퍼를 제공해야한다. 트랜스포트는 SetType 멤버안에 IrpSp->Parameters에서 이 정보를 찾는다. 입력에서 SetType은 다음의 시스템 정의 TDI_QUERY_XXX 서브셋일 수 있다:

TDI_QUERY_ADDRESS_INFO: 주소에 대한 정보를 설정해라. MdlAddress에 맵된 클라이언트 제공 버퍼는 TDI_ADDRESS_INFO 구조체로써 포맷된 데이타를 포함한다.
TDI_QUERY_CONNECTION_INFO: 연결 엔드포인트에 대해서 정보를 설정해라. MdlAddress에 맵된 클라이언트 제공 버퍼는 TDI_CONNECTION_INFO 구조체로써 포맷된 데이타를 포함한다.
TDI_QUERY_PROVIDER_INFO: 통제 채널에 대한 정보를 설정해라. MdlAddress에 맵된 클라이언트 제공 버퍼는 TDI_PROVIDER_INFO 구조체로써 포맷된 데이타를 포함한다.
TDI_QUERY_PROVIDER_STATISTICS: 통제 채널에 대한 통계정보를 설정해라. MdlAddress에 맵된 클라이언트 제공 버퍼는 TDI_PROVIDER_STATISTICS 구조체로써 포맷된 데이타를 포함한다.

트랜스포트는 클라이언트에 대해서 추가적인 셋 연산을 지원하기 위해서 드라이버 개발자의 결정에서 이 인터페이스를 확장할 수 있다. 그러한 트랜스포트는 가장 중요한 비트가 설정된 TDI_QUERY_XXX 코드를 정의해야한다.

트랜스포트는 파일 객체안에 명시된 SetType을 부적절하게 하므로써 셋 정보 리퀘스트를 실패해야한다.

또한 트랜스포트는 드라이버 결정 제한을 초과한 값을 제공하는 클라이언트를 위해서 셋 정보 리퀘스트를 실패할 수 있다. 예를들어 대부분의 트랜스포트는 그들의 클라이언트에게 TDI_QUERY_PROVIDER_INFO 타입의 셋 정보 리퀘스트를 가지고 MaxDatagramSize 혹은 MaxSendSize를 리셋하도록 허락하지 않는다.

TdiBuildSetInformation 함수는 클라이언트가 이 IRP를 채우기 위해서 사용하는 매크로이다.