TDI_ACTION

커널 모드 클라이언트가 TDI_ACTION 리퀘스트를 할 때 커널 모드 클라이언트는 하부의 TDI 트랜스포트 드라이버에게 그 클라이언트가 이용할 수 있는 트랜스포트 특정 확장을 하도록 요구한다.

IRP

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

Irp->IoStatus.Status

action 리퀘스트의 마지막 상태를 서술한다. 트랜스포트가 다음중에 하나로 IRP를 완료할 때 이 멤버를 설정한다:

STATUS_SUCCESS
STATUS_PENDING
STATUS_INVALID_CONNECTION
STATUS_INVALID_PARAMETER
STATUS_INVALID_HANDLE
STATUS_BUFFER_TOO_SMALL
STATUS_INSUFFICIENT_RESOURCES
STATUS_NOT_SUPPORTED
STATUS_NOT_IMPLEMENTED


Irp->IoStatus.Information

이 리퀘스트를 위해서 전송된 데이타의 바이트가 얼마나 많은지를 서술한다. 트랜스포트는 IRP가 완료되기 전에 I/O 상태 블럭의 이 멤버를 설정한다.

IrpSp->MajorFunction

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

IrpSp->MinorFunction

TDI_ACTION을 서술한다.

IrpSp->FileObject

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

Irp->MdlAddress

클라이언트가 제공하는 action 매개변수 블럭을 포함하고 있는 버퍼를 매핑하는 체인화된 처음의 MDL을 가리킨다. 이 버퍼의 처음 부분은 항상 트랜스포트 정의 내용이 action 리퀘스트를 수행하기 위해서 요구되었는지에 따라서 시스템 정의 TDI_ACTION_HEADER 구조체를 포함한다.

주석

클라이언트의 성공적인 action 리퀘스트 완료는 트랜스포트 제공 확장을 클라이언트에게 적용할 수 있게 한다. 하지만 다른 TDI 클라이언트나 드라이버에게는 아니다. 가능한 동작들은 TDI 트랜스포트 드라이버의 개발자의 결정에서 트랜스포트에 의해서 정의된다.

그러한 클라이언트는 주소, 연결 엔드포인트, 통제 채널과 관련된 트랜스포트 정의 확장을 위해서 action 리퀘스트를 한다. 클라이언트는 MdlAddress에 맵된 매개변수 블럭안에 리퀘스트된 동작에 관한 모든 정보를 포함하는 버퍼를 제공한다.

각각의 action 매개변수 블럭은 트랜스포트 식별자와 action 코드를 포함하는 TDI_ACTION_HEADER를 가지고 시작한다. 그러한 리퀘스트를 받을 때 트랜스포트는 리퀘스트를 유효화하기 위해서 이 헤더안에 TransportId 값을 사용한다. ActionCode 멤버는 수행되는 트랜스포트 정의 연산을 서술하고 매개변수 블럭의 나머지를 위한 트랜스포트 요구 내용을 결정한다.

TdiBuildAction은 클라이언트가 이 IRP안에 채우기 위해서 사용하는 매크로이다.