FDDI_COMPARE_NETWORK_ADDRESSES

VOID
    FDDI_COMPARE_NETWORK_ADDRESSES(
        IN PUCHAR  A,
        IN PUCHAR  B,
        IN ULONG  AddressLength,
        OUT PINT  Result
        );

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.

Parameters

A

Points to the first network address.

B

Points to the second network address.

AddressLength

Specifies the length in bytes of the addresses (either 2 or 6).

Result

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

Comments

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.

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.