TdiCopyLookaheadData

VOID
   TdiCopyLookaheadData(
       IN PVOID Destination,
       IN PVOID Source,
       IN ULONG Length,
       IN ULONG ReceiveFlags
       );

TdiCopyLookaheadData 함수는 하부의 NDIS 드라이버에 의해서 트랜스포트 드라이버에 lookahead 버퍼로 인디케이트된 리시브 데이타를 안전하게 복사한다.

매개변수

Destination

데이타가 복사될 호출자 제공 버퍼를 가리킨다.

Source

데이타 복사를 위해서 사용되는 소스 버퍼를 가리킨다.

Length

데이타가 얼마나 많이 복사되는지를 서술한다.

ReceiveFlags

다음의 플래그만이 이 호출에서 적절하고 TDI_RECEIVE_XXX 플래그의 결합(OR)을 서술한다:

TDI_RECEIVE_COPY_LOOKAHEAD

OID_GEN_MAC_OPTIONS 쿼리를 가진 NdisRequest 함수의 프로토콜 바인딩시 호출에 대한 응답으로 하부의 NIC 드라이버가 NDIS_MAC_OPTION_COPY_LOOKAHEAD_DATA 플래그를 설정한다면 설정되어야한다. 반면에 이 플래그는 주어진 ReceiveFlags에서 클리어되어야한다.

주석

TdiCopyLookaheadData 함수는 NIC 드라이버에 의해서 인디케이트되는 lookahead 버퍼로부터 리시브 데이타를 복사하기 위해서 트랜스포트의 ProtocolReceive 함수에 의해서 호출될 수 있다. 특히 하부의 NIC 드라이버가 트랜스포트의 OID_GEN_MAC_OPTIONS 쿼리에 대한 응답으로 NDIS_MAC_OPTION_COPY_LOOKAHEAD_DATA 플래그를 설정하지 않는다면 TdiCopyLookaheadData 함수는 호출되어야한다. 이 OID 리퀘스트에 대한 더 많은 정보는 Part 2를 봐라.

그러나 TdiCopyLookaheadData 함수는 하부의 NIC에서 리시브된 버퍼의 특성이 무엇이든지 NDIS 드라이버의 ProtocolReceive 함수에 의해서 호출될 수 있다.

ProtocolReceive 함수를 익스포트하는 어떤 드라이버는 TdiCopyLookaheadData 함수를 호출할 수 있다.

TdiCopyLookaheadData 함수의 호출자는 Destination의 버퍼가 비페이지화된 풀에 할당된다면 어떤 IRQL에서도 실행할 수 있다. 반면에 호출자는 IRQL < DISPATCH_LEVEL에서 실행되어야한다.