TdiDispatchDeviceControl

NTSTATUS
   TdiDispatchDeviceControl (
       IN PDEVICE_OBJECT DeviceObject,
       IN PIRP Irp,
       IN PIO_STACK IrpSp
      );

TdiDispatchDeviceControl 함수는 메이저 함수 코드가 IRP_MJ_DEVICE_CONTROL로 설정된 IRP를 처리한다.

매개변수

DeviceObject

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

Irp

IRP를 가리킨다.

IrpSp

주어진 IRP 안에서 트랜스포트 드라이버의 I/O 스택 로케이션을 가리킨다.

리턴값

TdiDispatchDeviceControl 함수가 주어진 리퀘스트를 만족한다면 STATUS_SUCCESS를 리턴한다. 반면에 IRP안에 IOCTL_XXX 마이너 함수 코드에 의존하여 드라이버 결정 에러상태를 리턴한다.

주석

보통 TdiDispatchDeviceControl 함수가 TdiMapUserRequest 함수를 호출하고 STATUS_SUCCESS를 리턴한다면 입력 DeviceObject와 Irp 포인터를 가지고 트랜스포트의 TdiDispatchInternalDeviceControl 함수를 호출한다. Irp에서 주어진 IOCTL_XXX가 시스템 정의 IOCTL_TDI_XXX 코드와 일치하지 않는다는 것을 인디케이트하는 에러를 TdiMapUserRequest 함수가 리턴한다면 대부분의 트랜스포트는 STATUS_INVALID_DEVICE_REQUEST 혹은 STATUS_NOT_SUPPORTED와 같은 드라이버 결정 에어 상태를 가지고 IRP를 완료한다.

그러나 트랜스포트의 어플리케이션이 트랜스포트와 통신하기 위해서 사용하는 드라이버 결정 "전용" IOCTL을 트랜스포트가 지원한다면 트랜스포트의 TdiDispatchDeviceControl 함수는 이 IOCTL_XXX에서 스위치하고 그들을 처리하기 위해서 내부의 드라이버 함수를 호출한다. 이것은 마치 TdiMapUserRequest 함수가 STATUS_SUCCESS를 리턴할 때 TdiDispatchInternalDeviceControl 함수를 호출하는 것과 같다.

드라이버 정의 IOCTL 코드에 대한 더 많은 정보는 커널 모드 드라이버 레퍼런스를 봐라.