TdiBuildAction

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

TdiBuildAction 함수는 로컬의 클라이언트가 리퀘스트된 동작이 적용하는 주소, 연결 엔드포인트, 통제 채널을 이미 연 하부의 트랜스포트로 TDI_ACTION 리퀘스트에 대한 내부의 장치 통제 IRP를 설정한다.

매개변수

Irp

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

DevObj

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

FileObj

주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체를 가리킨다.

CompRoutine

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

Contxt

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

MdlAddr

클라이언트에 의해서 설정된 동작 매개변수 블럭을 포함하는 클라이언트 제공 버퍼를 매핑하는 MDL 체인의 헤드를 가리킨다. 이 버퍼는 트랜스포트 결정 정보가 동작 리퀘스트를 수행하기 위해서 필요한 것이 무엇인지에 의해서 판가름되는 시스템 정의 헤더를 포함한다.

주석

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

클라이언트는 주소, 연결, 통제 채널에 걸맞는 트랜스포트 제공 확장을 위해서 동작 리퀘스트를 할 수 있다. 클라이언트는 동작 매개변수 블럭안에 그러한 리퀘스트에 관하여 모든 트랜스포트 요구 정보를 포함하는 버퍼를 제공한다.

모든 동작 매개변수 블럭은 트랜스포트 식별자와 동작 코드를 포함하는 시스템 정의 TDI_ACTION_HEADER 구조체를 가지고 시작한다. 그러한 리퀘스트 받기에서 트랜스포트는 리퀘스트를 승인하기 위해서 이 헤더안에 TransportId 값을 사용한다. ActionCode 멤버는 매개변수 블럭의 나머지를 위해서 트랜스포트 요구 내용을 결정하고 수행하는 트랜스포트 정의 연산을 서술한다. 하부의 트랜스포트는 사용가능한 동작 코드의 집합과 각각의 동작을 위해서 유지되는 매개변수 블럭의 요구된 포맷을 정의한다.

어떤 클라이언트의 동작 리퀘스트에 대한 성공적인 완료는 트랜스포트 제공 확장을 그 클라이언트에 적용되게 한다. 하지만 다른 TDI 클라이언트나 드라이버에는 적용되지 않는다.