NdisTransferData
VOID
NdisTransferData(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE NdisBindingHandle,
IN NDIS_HANDLE MacReceiveContext,
IN UINT ByteOffset,
IN UINT BytesToTransfer,
IN OUT PNDIS_PACKET Packet,
OUT PUINT BytesTransferred
);
|
NdisTransferData는 아랫계층의 NIC에서 받은 데이터를 카피하기 위한 요구를 프로토콜 제공 패킷에 보낸다.
매개변수
- NdisBindingHandle
- NdisOpenAdapter에 의해 리턴된 핸들값
- MacReceiveContext
- 아래 계층 드라이버 핸들
- ByteOffset
- 전송하기 시작할 곳의 수신 네트웍 패킷의 시작으로부터의 옵셋
- BytesToTransfer
- 전송하기 위한 바이트 수. 이 값은 0이 될 수 있다.
- Packet
- 호출자에 의해 제공되는 패킷 디스크립터로 아랫 계층의 NIC가 데이터를 카피할 장소이다.
- BytesTransferred
- 호출자가 제공할 변수이다. 이 함수는 실제 전송되어지는 바이트수를 리턴한다.
주석
몇몇 프로토콜들은 하나의 아랫 계층 NIC과 바운드되어질 수 있다. 그리고 각 그러한 프로토콜 드라이버들은 같은 패킷을 위한 지시를 받을 수 있다. 그러한 패킷은 프로토콜 드라이버에게는 읽기 전용이다. 각 그러한 드라이버의 ProtocolReceive 함수는 NdisTransferData 함수로 지시된 패킷의 복사를 하느냐를 결정한다.
NdisTransferData를 호출하기 전에, 프로토콜은 패킷 디스크립터를 할당해야 하고, 아랫 계층 드라이버가 데이터를 카피하는 곳에 프로토콜 할당 버퍼들을 맵핑하는 몇가지 버퍼 디스크립터들을 연결(chain)해야 한다. 프로토콜은 또한 NdisTransferData를 호출하기 전에 패킷 디스크립터의 ProtocolReserced 부분을 설정해야 한다.
NdisTransferData 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.
|