NDIS_SET_PACKET_TIME_RECEIVED

  • Article

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

ULONGLONG NDIS_SET_PACKET_TIME_RECEIVED(
  PNDIS_PACKET _Packet,
  ULONGLONG _TimeReceived
);

Parameters

  • _Packet
    Pointer to a packet descriptor 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.

Return Values

The return value is _TimeReceived value.

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 indicated 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.

The NDIS_SET_PACKET_TIME_RECEIVED macro is defined as follows.

#define NDIS_SET_PACKET_TIME_RECEIVED(_Packet, _TimeReceived)   \
    ((PNDIS_PACKET_OOB_DATA)((PUCHAR)(_Packet) +                \
    (_Packet)->Private.NdisPacketOobOffset))->TimeReceived = (_TimeReceived)

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.

See Also

NdisGetCurrentSystemTime | NdisMIndicateReceivePacket | NdisMSendComplete | NdisSend | ProtocolReceive | ProtocolReceiveComplete

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.