INTERFACE_TIMESTAMP_CAPABILITIES structure (iphlpapi.h)

Describes the exact timestamp capabilities that a network adapter supports.

To retrieve the supported timestamp capabilities of a network adapter, call the GetInterfaceSupportedTimestampCapabilities function. That function returns the supported timestamping capabilities in the form of an INTERFACE_TIMESTAMP_CAPABILITIES object.

For more info, and code examples, see Packet timestamping.

Syntax

typedef struct _INTERFACE_TIMESTAMP_CAPABILITIES {
  ULONG64                                   HardwareClockFrequencyHz;
  BOOLEAN                                   SupportsCrossTimestamp;
  INTERFACE_HARDWARE_TIMESTAMP_CAPABILITIES HardwareCapabilities;
  INTERFACE_SOFTWARE_TIMESTAMP_CAPABILITIES SoftwareCapabilities;
} INTERFACE_TIMESTAMP_CAPABILITIES, *PINTERFACE_TIMESTAMP_CAPABILITIES;

Members

HardwareClockFrequencyHz

Type: ULONG64

Contains the frequency of the network adapter's hardware clock, rounded off to the nearest integer in Hertz units. Note this is the nominal frequency, and the actual frequency might not be the same as this. This data could be used to display the nominal clock frequency to end users for informational purposes. It's possible for HardwareClockFrequencyHz to contain the value 0.

SupportsCrossTimestamp

Type: BOOLEAN

A value of TRUE indicates that the network adapter driver is capable of generating a hardware cross timestamp. A cross timestamp refers to a set of network interface card (NIC) hardware timestamp and system timestamp(s) obtained very close to one another. A value of FALSE indicates that this capability doesn't exist.

HardwareCapabilities

Type: INTERFACE_HARDWARE_TIMESTAMP_CAPABILITIES

Describes the timestamping capabilities of the network interface card's (NIC's) hardware. Having both hardware and software timestamps enabled together isn't supported.

SoftwareCapabilities

Type: INTERFACE_SOFTWARE_TIMESTAMP_CAPABILITIES

Describes the software timestamping capabilities of a network interface card's (NIC's) miniport driver. Having both hardware and software timestamps enabled together isn't supported.

Requirements

Requirement Value
Minimum supported client Windows 11 (Build 10.0.22000.194)
Minimum supported server Windows Server 2022
Header iphlpapi.h

See also

Packet timestamping