 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This macro sets the TimeReceivedvalue 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 NdisMIndicateReceivePacketfunction. Miniports that indicate multipacket receives can set the TimeReceivedparameter 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 NdisGetCurrentSystemTimefunction.
All time stamps set in the NDIS_PACKET_OOB_DATAstructures associated with packet descriptors are expressed in system time units as the number of 100-nanosecond intervals since January 1, 1601. A driver calls NdisGetCurrentSystemTimeto supply the TimeReceivedparameter to NDIS_SET_PACKET_TIME_RECEIVED.
If the ProtocolReceivefunction is called with an indicated packet descriptor for which the underlying driver set the TimeReceivedtime stamp, ProtocolReceivecalls NdisQueryReceiveInformationto 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