NdisMWanIndicateReceive
VOID
NdisMWanIndicateReceive(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_HANDLE NdisLinkContext,
IN PUCHAR PacketBuffer,
IN UINT PacketSize
);
|
NdisMWanIndicateReceive 함수는 패킷이 적절하게 바인딩된 프로토콜 드라이버로 전달되는 성립된 연결에 대해서 받았다는 것을 NDISWAN에게 통보한다.
매개변수
- Status
- 다음 중 하나가 될 수 있는 인디케이션의 상태를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다:
- NDIS_STATUS_SUCCESS
- NDISWAN이 패킷을 인식해서 받아들였다.
- NDIS_STATUS_NOT_ACCEPTED
- NDISWAN이 프레임을 인식하지 못했다.
다른 상태는 NDISWAN이 프레임을 인식했지만 몇몇 이유로 그것을 받아들일 수 없음을 인디케이트한다.
- MiniportAdapterHandle
- MiniportInitialize 함수로 입력되는 핸들을 서술한다.
- NdisLinkContext
- 연결에 대해서 미니포트가 NdisMIndicateStatus 함수로의 처음 호출에서 NDIS_MAC_LINE_UP 구조체 안에 NDISWAN에 의해서 제공된 핸들을 서술한다.
- PacketBuffer
- 리시브된 패킷을 포함하는 버퍼의 기본 가상 주소를 서술한다.
- PacketSize
- 리시브된 패킷 데이타의 바이트 사이즈를 서술한다.
주석
미니포트가 NdisMWanIndicateReceive 함수를 호출할 때, NDISWAN은 바인딩된 프로토콜 드라이버의 ProtocolReceive 함수를 호출하므로써 패킷을 인디케이트한다. wan 미니포트는 패킷 데이타의 lookahead 부분을 가지고 부분적인 패킷을 인디케이트하지 않기 때문에 전체 패킷은 검사를 위해서 프로토콜에 의해서 사용될 수 있다.
결과적으로 그러한 프로토콜은 결코 NdisTransferData 함수를 호출하지 않는다. 그래서 하부의 미니포트 드라이버는 MiniportTransferData 함수를 가질 필요가 없다. 미니포트는 항상 전송하는 노드에서 패킷에 적용된 암호화와 압축으로 인해서 전체 패킷을 항상 위로 전달한다. 또한 연결이 포인트 대 포인트이기 때문에 적어도 하나의 상위 레벨 프르토콜이 각각의 리시브 패킷을 받아들인다.
NdisMWanIndicateReceive 함수를 통해서 인디케이션을 받은 어떤 프로토콜에 대해서 PacketBuffer에 버퍼는 ProtocolReceive 함수로의 현재 호출동안에만 유효하다. 패킷이 압축됐을 수도 있기 때문에 전체 패킷은 이 호출이 행해질 때 사용가능하다. 이 버퍼는 원격지의 드라이버에 의해서 보내진 버퍼와 같은 데이타와 사이즈를 포함해야한다.
헤더에 포함된 데이타는 nic에서 받은 데이타와 같다. WAN 미니포트는 NIC이 받은 데이타에서 헤더와 트레일러를 제거할 필요가 없다. 전송중인 드라이버는 패킷에 데이타를 추가하지 않는다.
NdisMWanIndicateReceive 함수의 직렬화된 호출자는 IRQL DISPATCH_LEVEL에서 실행한다. NdisMWanIndicateReceive 함수의 비직렬화된 호출자는 IRQL DISPATCH_LEVEL 아하에서 실행할 수 있다.
|