Microsoft Windows CE 3.0  

NDIS_SET_PACKET_TIME_RECEIVED

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

© 2004 Microsoft Corporation. All rights reserved.