NDIS_SET_PACKET_TIME_RECEIVED

This macro sets the TimeReceived value in the out-of-band data block associated with a specified packet descriptor.

NDIS_SET_PACKET_TIME_RECEIVED(
IN PNDIS_PACKET Packet, 
IN ULONGLONG TimeReceived );

Parameters

• Packet
  Pointer to a packet desciptor allocated by the caller for receive indications.
• TimeReceived
  Specifies the system time at which the packet was received from the remote node on the network.

Remarks

Drivers use this macro to set this time stamp in the out-of-band data block associated with a packet descriptor before calling the NdisMIndicateReceivePacket function. Miniports that indicate multipacket receives can set the TimeReceived parameter for each packet in an idicated array to the same value before making an indication, particularly if the NIC has no internal clock, so the NIC driver calls the NdisGetCurrentSystemTime function.

All time stamps set in the NDIS_PACKET_OOB_DATA structures associated with packet descriptors are expressed in system time units as the number of 100-nanosecond intervals since January 1, 1601. A driver calls NdisGetCurrentSystemTime to supply the TimeReceived parameter to NDIS_SET_PACKET_TIME_RECEIVED.

If the ProtocolReceive function is called with an indicated packet descriptor for which the underlying driver set the TimeReceived time stamp, ProtocolReceive calls NdisQueryReceiveInformation to get this time stamp.

A driver that calls this macro runs in IRQL <=DISPATCH_LEVE.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Ndis.h

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

NDIS_SET_PACKET_TIME_SENT, NdisMIndicateReceivePacket

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.