TdiDispatchFastDeviceControl

BOOLEAN
   TdiDispatchFastDeviceControl (
       IN STRUCT FILE_OBJECT *FileObject,
       IN BOOLEAN Wait,
       IN PVOID InputBuffer,
       IN ULONG InputBufferLength,
       IN OUT PVOID OutputBuffer,
       IN ULONG OutputBufferLength,
       IN ULONG IoControlCode,
       OUT PIO_STATUS_BLOCK IoStatus
      );

TdiDispatchFastDeviceControl 함수는 트랜스포트에 의해서 이미 내부적으로 버퍼화된 데이타를 리턴하는 선택적인 TDI 트랜스포트 드라이버 함수이다.

매개변수

FileObject

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

Wait

드라이버가 TdiDispatchFastDeviceControl 함수 호출의 컨텍스트에서 기다릴 수 있다면 TRUE를 서술한다.

InputBuffer

주어진 IoControlCode에 의해서 요구되는 호출자 제공 정보를 포함하는 입력 버퍼를 선택적으로 가리킨다.

InputBufferLength

입력 버퍼의 바이트 사이즈를 서술한다.

OutputBuffer

트랜스포트가 리퀘스트된 데이타를 리턴하는 출력 버퍼를 선택적으로 가리킨다.

OutputBufferLength

출력 버퍼의 바이트 사이즈를 서술한다.

IoControlCode

리퀘스트된 연산에 대한 IOCTL_TDI_XXX 코드를 서술한다. 이 값은 ntddtdi.h에 정의된 코드중에 하나여야한다.

유효한 IOCTL_TDI_XXX 코드의 모음은 신속한 I/O 지원에 의존한다. 그렇다 하더라도 개개의 트랜스포트에 의해서 제공되고 그 트랜스포트는 자신의 내부 버퍼에 유지하는 것에 의존한다. 일반적으로 트랜스포트는 기대되는 IOCTL_TDI_RECEIVE 리퀘스트를 만족시키는, 가능하다면 IOCTL_TDI_QUERY_INFORMATION 리퀘스트를 만족시키기 위해서 사용되는 데이타를 버퍼화하는 게 낫다.

하부의 트랜스포트 드라이버와 통신하기 위해서 윈도우즈 소켓에 대한 지원을 제공하는 afd.sys 드라이버는 또한 리시브된 데이타를 위해서 신속한 경로를 제공하지 않는 시스템 트랜스포트에 대해서 앞으로 읽을 신속한 I/O 지원을 제공한다.

IoStatus

TdiDispatchFastDeviceControl 함수가 IO_STATUS_BLOCK 구조체로 포맷되는 완료 상태를 리턴하는 호출자 제공 변수를 가리킨다. TdiDispatchFastDeviceControl 함수는 Status와 Information 멤버를 주어진 IoControlCode에 대해서 적절하게 채운다.

리턴값

TdiDispatchFastDeviceControl 함수가 통제를 리턴하기 전에 커널 모드 클라이언트의 리퀘스트를 만족하거나 완성한다면 TRUE를 리턴한다.

주석

신속한 I/O 리퀘스트가 준비될 때 클라이언트는 IRP를 할당하거나 상위의 네트웍 층으로부터 전달되는 IRP를 사용한다.

I/O 매니저가 TdiDispatchFastDeviceControl 함수를 호출할 때 주어진 OutputBuffer는 보통 클라이언트 제공 IRP안에 Irp->MdlAddress에 버퍼와 대응한다. InputBuffer는 IoControlCode에 의존하는 리퀘스트를 위해서 클라이언트 제공 정보를 포함한다. TdiBuildInternalDeviceControlIrp 함수를 가지고 리스트된 TDI_XXX 마이너 함수코드에 반대하여 이 리퀘스트는 시스템 정의 사용자 모드 IOCTL이 리퀘스트를 확인하는 다른 커널 리퀘스트와는 다르다.

예를들어 IOCTL_TDI_SEND를 위해서 InputBuffer는 클라이언트 제공 TDI_REQUEST_SEND 구조체를 포함하고 OutputBuffer는 네트웍 상으로 보내지는 실제 데이타를 포함한다. IOCTL_TDI_RECEIVE를 위해서 InputBuffer는 TDI_REQUEST_RECEIVE 구조체를 포함하고 트랜스포트 드라이버는 OutputBuffer에 리시브된 데이타를 복사한다.

ntddtdi.h에 각각의 IOCTL_TDI_XXX 코드의 정의는 버퍼가 어떻게 설정되어야 하는지를 결정한다. IOCTL_XXX 코드를 어떻게 해석하는지에 대한 설명은 커널 모드 드라이버의 레퍼런스르 봐라.

버퍼의 매개변수가 트랜스포트를 위해서 설정됐을 때 트랜스포트가 이 루틴을 익스포트한다면 클라이언트는 TdiDispatchFastDeviceControl 함수로의 리퀘스트를 전달하기 위해서 IoCallDriver 함수를 호출한다. 트랜스포트가 신속한 I/O 리퀘스트를 즉시 완료할 수 없다면 TdiDispatchFastDeviceControl 함수는 FALSE를 리턴하고 I/O 매니저는 주어진 리퀘스트를 IRP_MJ_DEVICE_CONTROL IRP안으로 리패키지하고 트랜스포트 드라이버의 TdiDispatchDeviceControl 루틴으로 IRP를 제출한다. 반면에 TdiDispatchDeviceControl 함수는 가능하다면 리퀘스트를 처리하기 위해서 내부의 드라이버 함수를 호출하므로써 리퀘스트 자체를 만족한다. 아니면 리퀘스트를 실패한다. TdiDispatchDeviceControl 함수가 TRUE를 리턴할 때 트랜스포트는 원래 버퍼의 소유권을 클라이언트로 양도한다.

초기화시에 TDI 트랜스포트 드라이버는 입력 드라이버 객체에 FastIoDispatch 필드를 드라이버 할당 FAST_IO_DISPATCH 구조체의 주소로 설정하므로써 신속한 I/O 경로를 인에이블한다. 트랜스포트는 SizeOfFastIoDispatch 멤버를 채우고 FastIoDeviceControl을 트랜스포트의 TdiDispatchFastDeviceControl 함수의 엔트리 포인트로 설정해야한다; FAST_IO_DISPATCH 구조체의 다른 모든 멤버는 NULL로 설정되어야한다. 이 구조체와 드라이버 객체에 대한 더 많은 정보는 커널 모드 드라이버 레퍼런스를 봐라.

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