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
Target platform |
Desktop |
Version |
Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows XP. |
Header |
Ndis.h (include Ndis.h) |
IRQL |
Any level (see Remarks section) |