FDDI_COMPARE_NETWORK_ADDRESSES function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

FDDI_COMPARE_NETWORK_ADDRESSES sets a caller-supplied variable to a value indicating whether a given FDDI address is greater than, less than, or equal to another given FDDI address.

Syntax

VOID FDDI_COMPARE_NETWORK_ADDRESSES(
  _In_  PUCHAR A,
  _In_  PUCHAR B,
  _In_  ULONG  AddressLength,
  _Out_ PINT   Result
);

Parameters

• A [in]
  Pointer to the first network address.

• B [in]
  Pointer to the second network address.

• AddressLength [in]
  Specifies the length in bytes of the addresses (either 2 or 6).

• Result [out]
  Pointer to a caller-supplied variable in which this macro returns the result of its comparison as one of the following values:

  • Result < Zero
    B is greater than A.

  • Result > Zero
    A is greater than B.

  • Zero
    A equals B.

Return value

None

Remarks

A caller can use the FDDI_LENGTH_OF_SHORT_ADDRESS and FDDI_LENGTH_OF_LONG_ADDRESS constants, corresponding to two and six bytes, respectively, as the value for AddressLength. Note that FDDI_LENGTH_OF_SHORT_ADDRESS is an invalid value for AddressLength in Windows XP and later operating systems.

FDDI network addresses do not have a defined ordering relationship. Consequently, the results of this macro for unequal addresses depend on the argument ordering.

Callers of this macro can be running at any IRQL if all pointer parameters access resident memory.

Note   This macro is not available for use beginning with Windows Vista.

Requirements

Send comments about this topic to Microsoft