GetFrameDstAddressOffset function

The GetFrameDstAddressOffset function returns the offset to the destination address of a given frame.

Syntax

DWORD WINAPI GetFrameDstAddressOffset(
  _In_ HFRAME  hFrame,
  _In_ DWORD   AddressType,
  _In_ LPDWORD AddressLength
);

Parameters

hFrame [in]

Handle to the frame.

AddressType [in]

Type of the destination address. Specify one of the following values:

ADDRESS_TYPE_ETHERNET ADDRESS_TYPE_IP ADDRESS_TYPE_IPX ADDRESS_TYPE_TOKENRING ADDRESS_TYPE_FDDI ADDRESS_TYPE_XNS ADDRESS_TYPE_VINES_IP ADDRESS_TYPE_ATM.

AddressLength [in]

Length of the destination address, in bytes.

Return value

If the function is successful, the return value is the offset (measured in bytes) to the requested address type.

If the function is unsuccessful, the return value is minus one (-1).

Remarks

If the AddressType parameter is set to ADDRESS_TYPE_ETHERNET, the return value of the GetFrameDstAddressOffset function is always zero. The offset of an Ethernet address is always zero.

Experts and parsers can call the GetFrameDstAddressOffset function.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Netmon.h
Library	Nmapi.lib
DLL	Nmapi.dll