NDIS_SET_PACKET_TIME

NDIS_SET_PACKET_TIME_SENT

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

At a Glance

Header file:	Ndis.h
Windows CE versions:	2.0 and later

Syntax

NDIS_SET_PACKET_TIME_SENT( IN PNDIS_PACKET Packet,
IN ULONGLONG TimeSent );

Parameters

Packet: Pointer to a packet descriptor allocated by the caller for receive indications.
TimeSent: Specifies the system time at which the packet was transmitted over the network from a remote node.

Remarks

Miniports can use this macro to set this time stamp in the out-of-band data block associated with a packet descriptor that they are about to indicate with the NdisMIndicateReceivePacket function.

All time stamps set in the NDIS_PACKET_OOB_DATA structures associated with packets are expressed in system time units as the number of 100-nanosecond intervals since January 1, 1601.

When a protocol driver’s ProtocolReceivePacket function is called with such an indication, it can use the NDIS_GET_PACKET_TIME_SENT macro to retrieve the TimeSent time stamp, using the Packet pointer that it is given on entry.

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

A driver that uses this macro runs at IRQL <=DISPATCH_LEVEL.