MiniportTransferData

NDIS_STATUS MiniportTransferData( OUT PNDIS_PACKET Packet, OUT PUINT BytesTransferred, IN NDIS_HANDLE MiniportAdapterContext, IN NDIS_HANDLE MiniportReceiveContext, IN UINT ByteOffset, IN UINT BytesToTransfer );

MiniportTransferData는 멀티 패킷 리시브들 혹은 그리고 미디어 특정 정보를 NdisMIndicateReceivePacket으로 인디케이트하지 않는 NIC 드라이버들 내에서 필요한 함수이고 WAN 미디어는 지원하지 않는다.

매개변수

Packet

MiniportTransferData는 수신된 데이터를 복사해야 하는 연결된 버퍼들을 가진 패킷 디스크립터를 가리킨다.

BytesTransferred

MiniportTransferData가 패킷에 복사되어지는 바이트 수를 설정하는 변수를 가리킨다. 이 값은 만약 MiniportTransferData가 NDIS_STATUS_PENDING을 리턴한다면은 의미가 없다.

MiniportAdapterContext

드라이버가 MiniportInitialize에 의해 설정된 NIC 당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다.

MiniportReceiveContext

전에 NdisM..IndicateReceive에 전달된 컨텍스트 핸들을 지정한다. 미니포트는 이 값을 조사해서 복사하는 리시브를 결정할 수 있다.

ByteOffset

MiniportTransferData가 복사를 시작해야 하는 수신된 패킷내에서 offset를 지정한다. 만약 완전한 패킷이 복사되어진다면은, ByteOffset은 0이다.

BytesToTransfer

얼마나 많은 패킷이 복사되었는지를 지정한다. ByteOffset과 BytesToTransfer의 합이 미니포트의 리시브 인디케이션내에서 지정된 패킷 크기와 동등하거나 혹은 작게 될 것이다. 이 값은 0이 될 것이다.

리턴값

MiniportTransferData는 다음과 하나로 리턴할 수 있다:

NDIS_STATUS_SUCCESS

MiniportTransferData는 요구된 데이터를 프로토콜 제공 패킷에 복사하고 BytesTransferred는 복사된 바이트 수로 설정한다.

NDIS_STATUS_PENDING

드라이버는 NdisMTransferDataComplete에 대한 호출로 비동기적으로 전송을 완료할 것이다.

NDIS_STATUS_FAILURE

데이터가 복사되지 않거나 입력 전송 범위가 유효하지 않다.

주석

MiniportTransferData는 수신된 패킷의 내용들을 주어진 프로토콜 할당 패킷에 복사한다.

NDIS는 ProtocolReceive 함수가 NdisTransferData를 호출할 때 MiniportTransferData를 호출한다. 패킷과 관련된 미디어 헤더는 복사하지 않을 것이다. 단지 패킷의 데이터 부분이 복사될 수 있다. NdisTransferData에 전달되어지는 부분은 결코 미디어 헤더를 포함하지 않는다. 항상, MiniportTransferData에 ByteOffset 입력은 미니포트가 이미 lookahead buffer내에서 인디케이트된 데이터를 뺀다.(exclude)

미니포트는 한번 이상 주어진 패킷을 복사하기 위해 준비되어질 것이다. 만약 NIC이 주어진 패킷을 단지 한번만 읽는 것을 지원한다면은, 미니포트는 각 수신된 네트워크 패킷을 staging buffer에 복사해야 한다. MiniportTrasnferData는 얼마나 많은 버퍼 디스크립터들이 할당된 프로토콜에서 제공되는 지를 결정하기 위해 NdisQueryPacket를 호출할 수 있다. 프로토콜은 요구된 전송을 도모하는(accommodates) 패킷 디스크립터를 제공하는 책임이 있다. MiniportTransferData는 각 프로토콜 제공 버퍼내에 복사하는 데이터가 얼마나 되는지를 결정하기 위해 NdisQueryPacket를 호출할 수 있다.

MiniportTransferData는 만약 주어진 ByteOffset과 BytesToTransfer가 원래 인디케이트된 패킷 크기를 초과한다면은 요구를 실패할 수 있다. 대체적으로, MiniportTransferData가 간단히 유효한 ByteOffset에서 시작하는 모든 이용할 수 있는 데이터를 전송할 수 있다.

MiniportTransferData가 비동기적이라면은, 이 함수를 가지는 미니포트는 전송이 지연되는 동안 리시브 인디케이션들을 전달할 수 없다. 만약 MiniportTransferData가 NDIS_STATUS_PENDING을 리턴한다면은, 미니포트는 전송이 완료될 때 NdisMTransferDataComplete를 호출해야 한다.

NdisMIndicateReceivePacket로 패킷들을 인디케이트하는 드라이버는 그러한 드라이버는 항상 바운드된 프로토콜들에 대해 full 패킷들을 인디케이트하기 때문에 MiniportTransferDataComplete를 호출해야 한다.

인터럽트들이 아직 MiniportTransferData가 호출되어질 때 불가능될 것이다.

디폴트로, MiniportTransferData는 IRQL DISPATCH_LEVEL에서 실행한다.