ClientEventChainedReceiveExpedited

NTSTATUS
   ClientEventChainedReceiveExpedited(
       IN PVOID TdiEventContext,
       IN CONNECTION_CONTEXT ConnectionContext,
       IN ULONG ReceiveFlags,
       IN ULONG ReceiveLength,
       IN ULONG StartingOffset,
       IN PMDL Tsdu,
       IN PVOID TsduDescriptor
       );

ClientEventChainedReceiveExpedited 함수는 클라이언트가 성립된 엔드포인트 대 엔드포인트 연결을 가지고 원격지로부터 들어오는 신속한 리시브에 대한 응답으로 하부의 TDI 트랜스포트가 호출하는 이벤트 핸들러이다.

클라이언트가 NDIS 미니포트에 의해서 트랜스포트로 인디케이트된 전체 TSDU를 전달하고 클라이언트가 데이타를 서비할 때까지 버퍼화된 TSDU로의 직접 읽기 전용접근을 얻을 수 있을 때 트랜스포트는 ClientEventReceiveExpedited 함수보다는 이 핸들러를 호출한다.

매개변수

TdiEventContext

ClientEventChainedReceiveExpedited 함수를 등록하기 위해서 클라이언트가 TdiBuildSetEventHandler 함수를 가지고 전에 설정한 IRP안에 제공한 컨텍스트를 가리킨다.

ConnectionContext

이 연결 엔드포인트를 위한 클라이언트의 컨텍스트를 가리킨다. ClientEventConnect 핸들러가 원격지로부터 연결제공을 승인하고 ZwCreateFile 함수를 가지고 연결 엔드포인트를 열었을 대 클라이언트는 전에 이 값을 하부의 트랜스포트로 제공했다.

ReceiveFlags

다음 플래그들의 OR 연산으로써 리시브 인디케이션의 특징을 서술한다:

TDI_RECEIVE_EXPEDITED

Tsdu에 맵된 버퍼는 클라이언트의 원격지로부터 리시브된 신속한 데이타를 포함한다. ClientEventChainedReceiveExpedited 함수가 호출될 때 이 플래그는 항상 설정된다.

TDI_RECEIVE_ENTIRE_MESSAGE

Tsdu에 맵된 버퍼는 전체 TSDU를 포함하고 클라이언트는 ClientEventChainedReceiveExpedited 함수가 STATUS_PENDING을 리턴할 때 인디케이트된 데이타를 소비할 때까지 이 버퍼로의 읽기 전용접근을 유지한다.

ReceiveLength

Tsdu에 맵된 버퍼안에 클라이언트 데이타의 바이트 수를 서술한다.

StartingOffset

Tsdu에 맵된 버퍼안에서 클라이언트 데이타가 시작하는 바이트 옵셋을 서술한다.

Tsdu

리시브된 데이타를 포함하는 버퍼를 매핑하는 체인화된 MDL의 처음 MDL을 가리킨다.

TsduDescriptor

리시브된 TSDU에 대한 디스크립터를 가리킨다. ClientEventChainedReceiveExpedited 함수가 이 리시브 인디케이션에 대해서 STATUS_PENDING을 리턴한다면 클라이언트는 순차적으로 이 포인터를 가지고 TdiReturnChainedReceives 함수를 호출해야한다. 이 포인터는 ClientEventChainedReceiveExpedited 함수가 STATUS_PENDING을 리턴한다면 TdiReturnChainedReceives 함수에 대한 매개변수로써만이 클라이언트에 의해서 사용되는 불투명한 변수에 대한 핸들로써 취급되어야한다.

리턴값

ClientEventChainedReceiveExpedited 함수는 다음중 하나를 리턴한다:

STATUS_SUCCESS

클라이언트가 주어진 TSDU안에 모든 데이타를 소비했고 즉시 버퍼의 소유권을 리턴하는 중이라고 인디케이트한다.

STATUS_PENDING

클라이언트가 주어진 TsduDescriptor를 가지고 TdiReturnChainedReceives 함수를 호출할 때까지 주어진 TSDU를 포함하는 버퍼의 소유권을 유지하고 있다고 인디케이트한다.

STATUS_DATA_NOT_ACCEPTED

클라이언트가 TSDU와 무관하다고 인디케이트한다.

하부의 트랜스포트가 내부적으로 리시브들을 버퍼화할 때 트랜스포트가 ClientEventChainedReceive(Xxx) 핸들러로 인디케이트된 버퍼화된 데이타를 버리지 않는다면 클라이언트는 TDI_RECEIVE 리퀘스트를 가지고 데이타를 얻는다.

주석

ClientEventChainedReceiveExpedited 함수로의 호출은 입력 StartingOffset과 ReceiveLength에 의해서 서술된 버퍼안에 범위에 대해서 인디케이트된 TSDU로의 읽기전용접근을 클라이언트에게 준다. 인디케이트된 데이타가 클라이언트와 관계가 있다면 ClientEventChainedReceiveExpedited 함수는 클라이언트 할당 내부 버퍼안으로 인디케이트된 TSDU 데이타의 범위를 복사하고 즉시 STATUS_SUCCESS를 리턴하거나 STATUS_PENDING을 리턴하므로써 버퍼의 통제를 유지한다. STATUS_PENDING을 리턴한다면 클라이언트는 데이타를 소비한 후에 버퍼의 통제를 양도하기 위해서 입력 TsduDescriptor를 가지고 순차적으로 TdiReturnChainedReceives 함수를 호출해야한다.

일반적으로 TdiReturnChainedReceives 함수로의 그러한 호출은 가능한 한 빨리 발생되어야한다. 연장된 기간동안 ClientEventChainedReceiveExpedited 함술로 전달되는 버퍼를 유지는 것은 하부의 드라이버에서 I/O 효율을 강요한다. 왜냐하면 버퍼를 할당한 NDIS 미니포트는 TdiReturnChainedReceives 함수가 호출될 때까지 순차적인 리시브 인디케이션을 가지고 이 자원을 다시 사용할 수 없기 때문이다.

ClientEventChainedReceiveExpedited 함수로의 호출이 항상 전체 TSDU의 사용을 인디케이트하기 때문에 클라이언트는 대응하는 ClientEventReceiveExpedited 핸들러가 가끔 전체 TSDU를 얻어야할 때 그러한 인디케이션에 대해서 TDI_RECEIVE 리퀘스트를 결코 설정해서는 안된다. 결국 ClientEventChainedReceiveExpedited 함수로 만들어진 리시브 인디케이션은 클라이언트, 하부의 트랜스포트, 시스템 전체에 대해서 호출의 과부하를 줄임으로써 네트웍 I/O 효율과 퍼포먼스를 증가시킨다. 트랜스포트는 ClientEventChainedReceiveExpedited 함수로 만든 같은 인디케이션을 가지고 대응하는 ClientEventReceiveExpedited 핸들러를 결코 호출해서는 안된다.

ClientEventChainedReceiveExpedited 함수가 STATUS_SUCCESS나 STATUS_DATA_NOT_ACCEPTED를 가지고 통제를 리턴할 때 하부의 트랜스포트는 클라이언트가 이 리시브 인디케이션을 가지고 행해졌다고 가정한다. 클라이언트가 STATUS_PENDING을 리턴한다면 트랜스포트는 클라이언트가 인디케이트된 TSDU를 소비했을 때 TdiReturnChainedReceives 함수 호출의 책임이 있기 때문에 이 리시브 인디케이션의 완료를 트랙할 방법이 없다고 가정한다.

ClientEventChainedReceiveExpedited 함수는 IRQL DISPATCH_LEVEL에서 연산을 수행할 능력이 있어야한다.