TdiMapUserRequest

NTSTATUS
   TdiMapUserRequest(
       IN PDEVICE_OBJECT DeviceObject,
       IN PIRP Irp,
       IN PIO_STACK_LOCATION IrpSp
       );

TdiMapUserRequest 함수는 입력 IRP에 서술된 IOCTL_TDI_XXX 코드를 인식한다면 MajorFunction이 IRP_MJ_DEVICE_CONTROL로 설정된 주어진 IRP를 IRP_MJ_INTERNAL_DEVICE_CONTROL 리퀘스트로 바꾼다.

매개변수

DeviceObject

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

Irp

변환되는 사용자 IOCTL_XXX 리퀘스트를 가리킨다.

IrpSp

변환되는 I/O 스택 로케이션을 가리킨다.

트랜스포트의 TdiDispatchDeviceControl 루틴은 이 포인터를 얻기 위해서 미리 IoGetCurrentIrpStackLocation 함수를 호출했다.

리턴값

TdiMapUserRequest 함수가 주어진 IOCTL_TDI_XXX 장치통제 리퀘스트를 TDI_XXX 내부 장치통제 리퀘스트로 바꾼다면 이 함수는 STATUS_SUCCESS를 리턴한다. 그렇지 않으면 다음중 하나를 리턴할 수 있다:

STATUS_INVALID_PARAMETER

IOCTL_TDI_SET_EVENT_HANDLER가 입력 IRP의 주어진 I/O 스택 로케이션에 서술된다면 사용된다.

STATUS_NOT_IMPLEMENTED

TdiMapUserRequest 함수가 입력 IRP의 주어진 I/O 스택 로케이션에 서술된 IOCTL_XXX 코드를 인식하지 못한다면 사용된다.

주석

트랜스포트의 TdiDispatchDeviceControl 루틴으로 전달된 IRP에 설정될 수 있는 시스템 정의 IOCTL_TDI_XXX 코드의 대부분을 위해서 TdiMapUserRequest 함수는 대응하는 커널 모드 TDI_XXX 리퀘스트의 포맷으로 현재 I/O 스택 로케이션을 바꾼다.

예를들어 IrpSp->Parameters.DeviceIoControl.IoControlCode가 입력 IRP에 IOCTL_TDI_LISTEN으로 설정된다면 TdiMapUserRequest 함수는 다음과 같이 I/O 스택 로케이션을 다시 포맷한다:

• IRP_MJ_INTERNAL_DEVICE_CONTROL로 MajorFunction을 리셋한다.
• MinorFunction을 TDI_LISTEN으로 설정한다.
• 입력 Irp->AssociatedIrp.SystemBuffer가 NULL이 아니라면, IrpSp->Parameters를 호출자 제공 정보를 가지고 설정된 TDI_REQUEST_KERNEL_LISTEN 구조체의 주소로 설정해라.

커널 모드 TDI_REGISTER_EVENT_HANDLER가 대응하는 사용자 IOCTL_TDI_REGISTER_EVENT_HANDLER를 가지는 동안에 TdiMapUserRequest 함수는 그 입력 IRP를 맵하기 위한 시도를 실패한다. 커널 모드 클라이언트만이 TDI 트랜스포트를 가지고 이벤트 핸들러를 등록할 수 있다. 그래서 트랜스포트의 TdiDispatchDeviceControl 루틴은 이벤트 핸들러를 설정하기 위해서 유효한 리퀘스트를 가지고 호출될 수 없다.

트랜스포트와의 통신에 대해서 트랜스포트에 헌신적인 Win32 어플리케이션에 의해서 사용되는 전용 IOCTL_XXX 코드를 트랜스포트가 정의한다면 트랜스포트의 TdiDispatchDeviceControl 루틴은 TdiMapUserRequest 함수가 STATUS_NOT_SUPPORTED를 리턴하든 아니든 그러한 리퀘스트를 처리할 수 있다. 정의된 드라이버 특정 전용 IOCTL에 대한 더 많은 정보는 커널 모드 드라이버 레퍼런스를 봐라.

TdiMapUserRequest 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.