ClientEventReceiveExpedited

NTSTATUS
   ClientEventReceiveExpedited (
       IN PVOID TdiEventContext,
       IN CONNECTION_CONTEXT ConnectionContext,
       IN ULONG ReceiveFlags,
       IN ULONG BytesIndicated,
       IN ULONG BytesAvailable,
       OUT ULONG *BytesTaken,
       IN PVOID Tsdu,
       OUT PIRP *IoRequestPacket
      );

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

매개변수

TdiEventContext

ClientEventReceiveExpedited 함수가 하부의 트랜스포트를 가지고 등록했을 때 TdiBuildSetEventHandler 함수를 가지고 설정된 IRP안에 제공된 호출자 제공 컨텍스트를 가리킨다.

ConnectionContext

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

ReceiveFlags

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

TDI_RECEIVE_EXPEDITED

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

TDI_RECEIVE_ENTIRE_MESSAGE

Tsdu에 버퍼는 전체 TSDU를 포함한다. ClientEventReceiveExpedited 함수는 TSDU를 받아들인다면 내부의 버퍼안으로 인디케이트된 데이타를 복사한 후에 가능한 한 빨리 통제를 리턴해야한다.

이 플래그가 클리어된다면(혹은 TDI_RECEIVE_PARTIAL이 리거시 프로토콜에 의해서 설정된다면) ClientEventReceiveExpedited 함수는 TSDU가 얼마나 많이 제공됐는지를 결정하기 위해서 BytesIndicated와 BytesAvailable 매개변수를 검사해야한다. 리거시 트랜스포트가 계속 TDI_RECEIVE_PARTIAL 플래그로 설정되어 있다고 하더라도 새로운 트랜스포트는 그들의 클라이언트로 부분적인 TSDU를 인디케이트하기 위해서 TDI_RECEIVE_ENTIRE_MESSAGE 플래그를 클리어한 채로 남겨둔다.

TDI_RECEIVE_COPY_LOOKAHEAD

TDI_RECEIVE_ENTIRE_MESSAGE가 설정되지 않는다면 BytesIndicated는 BytesAvailable 보다는 작은 값이 되고 ClientEventReceiveExpedited 함수는 내부의 버퍼안으로 인디케이트된 바이트의 수를 복사하고 BytesTaken에 변수를 설정해서 통제를 리턴한다. 클라이언트는 TSDU의 나머지를 얻기 위해서 하나이상의 TDI_RECEIVE 리퀘스트를 순차적으로 제출하거나 ClientEventReceiveExpedited 함수가 TSDU의 나머지를 복사하기 위해서 다시 호출될 수 있다.

TDI_RECEIVE_FRAGMENT

Tsdu에 버퍼는 단편화된 TSDU를 포함한다.

TDI_RECEIVE_PEEK

트랜스포트는 내부적으로 몇몇 리시브 데이타를 버퍼화하지만 아직은 전체 TSDU를 버퍼화한 것은 아니다. 클라이언트는 TSDU에 대해서 TDI_RECEIVE 리퀘스트를 제시했는지를 결정하기 위해서 Tsdu에 버퍼를 검사한다.

BytesIndicated

Tsdu에 버퍼안에 신속한 데이타의 바이트 수를 서술한다. 이 매개변수는 BytesAvailable의 값보다 항상 작거나 같다. 리시브된 메세지 혹은 스트림 세그먼트의 길이가 128 바이트 보다 작지 않다면 TDI 트랜스포트는 클라이언트로의 리시브 인디케이션에서 적어도 데이타의 128 바이트를 제공한다. BytesAvailable이 BytesIndicated 보다도 크다면 트랜스포트는 ClientEventReceiveExpedited 함수를 호출할 때 사용하지 않는 데이타를 받는다.

BytesAvailable

리시브된 TSDU안에 전체 바이트 수를 서술한다.

BytesTaken

TSDU로부터 복사되는 데이타의 바이트 수를 리턴하는 ClientEventReceiveExpedited 함수의 호출자 제공 변수를 가리킨다.

Tsdu

리시브된 TSDU 데이타를 포함하는 버퍼를 가리킨다.

IoRequestPacket

TdiBuildReceive 함수를 가지고 설정된 IRP에 대한 포인터를 리턴하는 ClientEventReceiveExpedited 함수의 변수를 가리킨다. 이 매개변수가 NULL이면 클라이언트는 TSDU의 나머지에 대해서 리시브 리퀘스트를 하지 않을 것이다.

리턴값

ClientEventReceiveExpedited 함수는 다음중 하나를 리턴할 수 있다:

STATUS_SUCCESS

클라이언트가 주어진 TSDU에서 모든 데이타를 복사했음을 인디케이트한다.

STATUS_MORE_PROCESSING_REQUIRED

내부의 버퍼안으로 BytesIndicated를 복사한 후에 TSDU의 나머지를 리퀘스트하는 IRP를 클라이언트가 제공했음을 인디케이트한다.

STATUS_DATA_NOT_ACCEPTED

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

주석

ClientEventReceiveExpedited 함수는 성립된 엔드포인트 대 엔드포인트 연결에서 TDI 드라이버가 리시브한 신속한 TSDU를 받아들이거나 거절한다. 이 핸들러는 신속한 데이타의 흐름이 정상적인 데이타의 흐름을 대신하는 것을 제외하고는 ClientEventReceive 함수와 거의 비슷하다.

결국 하부의 트랜스포트는 정상적인 리시브 연산이나 ClientEventReceive(혹은 ClientEventChainedReceive)함수로의 인디케이션이 진행중인 동안에 연결상에서 ClientEventReceiveExpedited 함수를 호출할 수 있다. 이것이 발생한다면 정상적인 데이타의 흐름은 ClientEventReceiveExpedited 함수가 리턴되고 클라이언트가 TSDU에 대해서 신속한 모든 데이타를 받을 때까지 다시 시작하지 않는다. ClientEventReceiveExpedited 함수가 IoRequestPacket에 TDI_RECEIVE 리퀘스트를 제공한다면 이 리퀘스트는 또한 신속하지 않은 데이타에 대해서 클라이언트 제시 리퀘스트보다 높은 우선권을 가진다.

ClientEventReceiveExpedited 함수가 호출될 때 다음중 하나를 할 수 있다:

• STATUS_DATA_NOT_ACCEPTED를 리턴하므로써 데이타에 대한 사용을 할 수 없다면 인디케이트된 TSDU를 거절한다.
• TDI_RECEIVE_ENTIRE_MESSAGE가 ReceiveFlags에 설정되서 STATUS_SUCCESS를 리턴한다면 내부의 버퍼안으로 모든 데이타를 복사한다.
• TDI_RECEIVE_ENTIRE_MESSAGE가 클리어이면(혹은 TDI_RECEIVE_PARTIAL이 설정된다면) 인디케이트된 데이타의 일부 혹은 전체를 복사하고 수행되는 연산에 의존하여 다음중 하나를 리턴한다:

  클라이언트가 유지하는 TSDU 데이타를 얻기 위해서 IoRequestPacket에 TDI_RECEIVE 리퀘스트를 제공한다면 STATUS_MORE_PROCESSING_REQUIRED를 리턴한다.

  트랜스포트가 유지하는 TSDU 데이타를 가지고 다시 ClientEventReceiveExpedited 함수를 호출하고자 한다면 STATUS_SUCCESS를 리턴한다.

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