NdisCopyFromPacketToPacket
VOID
NdisCopyFromPacketToPacket(
IN PNDIS_PACKET Destination,
IN UINT DestinationOffset,
IN UINT BytesToCopy,
IN PNDIS_PACKET Source,
IN UINT SourceOffset,
OUT PUINT BytesCopied
);
|
NdisCopyFromPacketToPacket함수는 하나의 패킷으로부터 지정한 범위의 데이타를 다른 패킷으로 복사한다.
매개변수
- Destination
- 목적지 패킷 디스크립터 포인터.
- DestinationOffset
- 카피할 데이타를 쓸 시작정에대한 목적지 패킷내의 바이트 옵셋을 지정한다.
- BytesToCopy
- 카피할 바이트를 지정한다.
- Source
- 소스 패킷 디스크립터 포인터.
- SourceOffset
- 데이타를 카피하기 시작할 소스 패킷내의 바이트 옵셋을 지정한다.
- BytesCopied
- 이함수가 실제로 카피한 바이트 수를 리턴하는것에대한 호출자 할당 변수의 포인터. 이 수는 만약 소스 패킷이 데이타 부족이거나 목적이 패킷이 공간 부족이면 BytesToCopy값보다 작을수 있다.
주석
NdisCopyFromPacketToPacket함수의 호출자는 목적지 패킷을 할당한다. 소스 패킷이 아닐지라도. 목적지 패킷의 패킷 디스크립터는 데이타를 받기위해 체인된 충분한 버퍼 디스크립터들을 가져야만 한다.
만약 소스 패킷이 데이타가 부족하거나 목적이 패킷이 공간부족이면 지정한 바이트수가 복사되기전에 카피 연산은 멈춘다. 또 다른 경우에서, NdisCopyFromPacketToPacket함수는 소스로부터 목적지 패킷으로 성공적으로 복사한 바이트 수를 리턴한다.
NdisCopyFromPacketToPacket함수는 주어진 Source와 관계된 OOB정보를 Destination에 복사하지 않는다. 이 정보를 복사하기위해서, 드라이버는 NDIS_OOB_DATA_FROM_PACKET에의해 리턴된 포인터를 사용할수 있고 NdisMoveMemory함수를 호출한다.
드라이버는 NdisCopyFromPacketToPacket함수를 호출하기전에 가지고 있던 어떤 스핀 락을 해제해야만 한다.
NdisCopyFromPacketToPacket함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.
|