TdiBuildReceive

VOID
   TdiBuildReceive (
       IN PIRP Irp,
       IN PDEVICE_OBJECT DevObj,
       IN PFILE_OBJECT FileObj,
       IN PVOID CompRoutine,
       IN PVOID Contxt,
       IN PMDL MdlAddr,
       IN ULONG InFlags,
       IN ULONG ReceiveLen
      );

TdiBuildReceive 함수는 로컬 클라이언트가 원격지와 엔드포인트 대 엔드포인트 연결을 성립한 하부의 트랜스포트로 TDI_RECEIVE 리퀘스트를 위해서 내부 장치 통제 IRP를 설정한다.

매개변수

Irp

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

DevObj

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

FileObj

연결 엔드포인트를 구현하는 파일 객체를 가리킨다.

호출자는 이 연결 엔드포인트와 로컬 주소사이에서 관계를 설정하기 위해서 트랜스포트로 TdiBuildAssociateAddress 함수를 가지고 설정된 리퀘스트를 전에 성공했다. 관계가 성립됐을 때 또한 호출자는 TdiBuildConnect나 TdiBuildListen 함수의 호출을 가지고 설정된 리퀘스트를 성공적으로 제시하고 후에 TdiBuildAccept 함수를 가지고 설정된 리퀘스트를 성공하므로써 원격지와 엔드포인트 대 엔드포인트 연결을 성립했다.

CompRoutine

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

Contxt

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

MdlAddr

트랜스포트가 주어진 InFlags에 따라서 리시브된 TSDU를 전송하는 클라이언트 제공 버퍼를 매핑하는 체인화된 MDL의 처음 MDL을 가리킨다.

InFlags

다음의 플래그가 하나 혹은 그 이상으로 OR 연산되므로써 트랜스포트에 의해서 리턴된 리시브의 타입을 서술한다:

TDI_RECEIVE_NORMAL

클라이언트 제공 버퍼로 정상적인 TSDU를 리턴해라.

TDI_RECEIVE_EXPEDITED

클라이언트 제공 버퍼로 신속한 TSDU를 리턴해라.

TDI_RECEIVE_NORMAL과 TDI_RECEIVE_EXPEDITED가 설정되거나 둘다 설정되지 않았다면 하부의 트랜스포트는 이 리시브 리퀘스트에 대해서 TSDU의 타입을 인디케이트한다.

TDI_RECEIVE_PEEK

부분적인 TSDU이고 패킷이 그 클라이언트에 대한 것일 때 버퍼안으로 전송되는 TSDU의 나머지를 위해서 클라이언트가 또다른 리시브를 리퀘스트한다고 하더라도 원격지로부터 리시브가 도착하자마자 인디케이트된 데이타를 리턴해라.

이 플래그는 하부의 트랜스포트가 내부적으로 리시브된 데이타를 버퍼화할 때만 유효하다. 일반적으로 버퍼화되지 않은 트랜스포트를 위해서 내부적으로 데이타를 버퍼화하는 시스템 AFD 드라이버를 지난 클라이언트는 이 플래그를 사용할 수 있다.

ReceiveLen

클라이언트 제공 리시브 버퍼의 바이트 사이즈를 서술한다.

주석

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

클라이언트가 주어진 연결 엔드포인트를 위해서 ClientEvent(Chained)Receive(Expedited) 핸들러를 등록했다면 리시브 리퀘스트를 제시하는 것은 리시브 IRP가 만족할 때까지 ClientEvent(Chained)Receive(Expedited) 함수의 호출을 금지한다. 그리고나서 트랜스포트는 적절한 ClientEvent(Chained)Receive(Expedited) 핸들러로 다시 리시브를 인디케이트한다.

TDI_RECEIVE_PEEK 플래그가 설정되지 않는다면 클라이언트의 버퍼가 꽉차있거나 트랜스포트가 원격지로부터 레코드의 끝이라는 인디케이션을 받을 때까지 하부의 트랜스포트는 리시브된 데이타를 가지고 주어진 버퍼를 채운다. 이 플래그가 설정된다면 이 IRP가 전체 TSDU를 얻는 것을 만족할 때 클라이언트는 순차적인 리시브 리퀘스트를 제시해야한다.

하부의 트랜스포트가 원격지로부터 도착한 정상적이고 신속한 데이타를 받고 있다면 트랜스포트는 정상적인 리시브 연산을 미리 비워두고 클라이언트 제공 버퍼안으로 이미 전송된 정상적인 데이타를 가지고 클라이언트로 즉시 리턴해야한다. 이것이 발생할 때 클라이언트는 신속한 TSDU를 리시브하기 위해서 필요한 만큼의 많은 리시브 리퀘스트를 해야한다. 클라이언트가 도착하는 모든 신속한 데이타를 얻을 때 클라이언트는 다시 정상적인 데이타를 리시브하기 위해서 또다른 리시브 리퀘스트를 제시한다.

또한 클라이어트가 ZwReadFile 함수를 호출하므로써 엔드포인트 대 엔드포인트 연결 상에서 정상적인 TSDU를 리시브하는 동안에 클라이언트는 트랜스포트가 리시브 플래그를 인디케이트할 방법이 없기 때문에 이 방법으로 신속한 데이타를 리시브할 수 없다. 게다가 ZwReadFile 함수로의 호출은 하부의 트랜스포트가 레코드의 끝 인디케이션을 받았는지를 클라이언트에게 알리지 않는다.

ZwReadFile 함수 호출의 특징에 대해서는 커널 모드 드라이버 레퍼런스를 봐라.