NDIS_SET_PACKET_TIME_RECEIVED (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

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 Value

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

See Also

Reference

Network Driver Macros
NdisGetCurrentSystemTime
NdisMIndicateReceivePacket
NdisMSendComplete
NdisSend
ProtocolReceive
ProtocolReceiveComplete