TdiDispatchInternalDeviceControl

NTSTATUS
   TdiDispatchInternalDeviceControl (
       IN PDEVICE_OBJECT DeviceObject,
       IN PIRP Irp
      );

TdiDispatchInternalDeviceControl 함수는 커널 모드 클라이언트로부터 TDI_XXX 장치 통제 리퀘스트를 처리한다.

매개변수

DeviceObject

TDI 드라이버에 의해서 생성된 장치 객체를 가리킨다.

Irp

IRP를 가리킨다.

트랜스포트는 IrpSp로써 다음에 리스트된 IRP안에 자신의 I/O 스택 로케이션에 대한 포인터를 얻기 위해서 주어진 Irp를 가지고 IoGetCurrentIrpStackLocation 함수를 호출한다. 트랜스포트는 진행중인 내부의 장치 통제 리퀘스트에서 IRP의 다음의 멤버로 설정된 정보를 사용할 수 있다:

IoStatus.Status

연산의 마지막 상태를 서술한다. 트랜스포트는 TdiDispatchInternalDeviceControl 함수에 의해서 리턴되는 똑같은 값으로 이 멤버를 설정한다.

IoStatus.Information

보통 이 멤버는 0 으로 초기화된다. IrpSp->MinorFunction 값에 의존하여 트랜스포트는 이 멤버를 클라이언트로 리턴되는 데이타의 바이트 수로 리셋하거나 트랜스포트가 이 IRP를 완료하기 전에 전송된 데이타의 바이트 수로 리셋한다.

IrpSp->MajorFunction

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

IrpSp->MinorFunction

수행되는 연산을 위한 TDI_XXX 코드를 서술한다.

IrpSp->FileObject

주소, 연결 엔드포인트, 통제 채널을 구현하는 파일 객체를 가리킨다. 주소, 연결 엔드포인트, 통제 채널에서의 연산을 위한 드라이버 할당 상태를 접근하기 위해서 트랜스포트는 이 파일 객체안의 FsContext와 가능하다면 FsContext2 필드의 값을 사용한다.

리턴값

TdiDispatchInternalDeviceControl 함수가 리퀘스트된 연산을 성공적으로 완료한다면 STATUS_SUCCESS를 리턴한다. 반면에 그렇지 않다면 STATUS_INVALID_DEVICE_REQUEST 혹은 STATUS_INVALID_DEVICE_STATE같은 드라이버 결정 에러 상태를 리턴한다.

주석

리퀘스트를 준비할 때 커널 모드 클라이언트는 TdiBuildInternalDeviceControlIrp 함수를 가지고 IRP를 할당하거나 상위의 네느웍 층으로부터 전달된 IRP를 사용한다. IRP안에 MajorFunction 코드로써 IRP_MJ_INTERNAL_DEVICE_CONTROL과 MinorFunction 코드로써 대응하는 TDI_XXX를 가진 하부의 트랜스포트를 위해 IRP를 설정하기 위해서 클라이언트는 TdiBuildXxx 매크로를 호출한다. IRP가 설정됐을 때 클라이언트는 하부 트랜스포트의 TdiDispatchInternalDeviceControl 루틴으로 리퀘스트를 제출하기 위해서 IoCallDriver 함수를 호출한다.

어떤 TDI_XXX는 주소하고만 연관이 있고 나머지는 연결 엔드포인트와 연관이 있다. 그리고 TDI_XXX 코드의 서브셋은 주소, 연결 엔드포인트, 통제 채널과 연관이 있기 때문에 트랜스포트의 TdiDispatchInternalDeviceControl 루틴은 IrpSp->FileObject에 주어진 파일 객체가 주소, 연결 엔드포인트, 통제 채널을 구현하는지에 대한 결정을 한다. 다음은 TDI_XXX 코드가 각각을 위해서 처리되는 것을 요약한다:

주소를 구현하는 FileObject

TDI_SEND_DATAGRAM
TDI_RECEIVE_DATAGRAM
TDI_SET_EVENT_HANDLER

연결 엔드포인트를 구현하는 FileObject

TDI_SEND
TDI_RECEIVE
TDI_ASSOCIATE_ADDRESS
TDI_DISASSOCIATE_ADDRESS
TDI_CONNECT
TDI_DISCONNECT
TDI_LISTEN
TDI_ACCEPT

주소, 연결 엔드포인트, 통제 채널을 구현하는 FileObject

TDI_QUERY_INFORMATION
TDI_SET_INFORMATION
TDI_ACTION

트랜스포트가 처리하는 각각의 TDI_XXX를 위해서 TdiDispatchInternalDeviceControl 루틴은 보통 리퀘스트된 연산을 수행하기 위해서 내부의 드라이버 함수를 호출한다. 특히 이 멤버가 0 으로 설정된 IRP를 완료하기 위해서 TdiDispatchInternalDeviceControl 함수를 떠나는 IoStatus.Information을 적절한 값으로 설정할 수 있기 때문에 그 함수가 데이타를 전송한다면 내부의 드라이버 함수는 IRP를 완료한다. 각각의 그러한 내부 함수는 통제를 리턴하기 전에 TdiDispatchInternalDeviceControl 함수가 보급하는 NTSTATUS 타입의 값을 리턴한다.

여기서 언급된 각각의 TDI_XXX에 대한 더 많은 정보는 다음에 있는 Chapter 2를 봐라.

기본적으로 TdiDispatchInternalDeviceControl 함수는 IRQL PASSIVE_LEVEL에서 실행된다.