FDDI_IS_MULTICAST 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_IS_MULTICAST sets a caller-supplied variable to a Boolean value indicating whether a given FDDI address is a multicast address.

Syntax

VOID FDDI_IS_MULTICAST(
  _In_  PUCHAR   Address,
  _In_  ULONG    AddressLength,
  _Out_ PBOOLEAN Result
);

Parameters

• Address [in]
  Pointer to a network address.

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

• Result [out]
  Pointer to a caller-supplied variable in which this macro returns TRUE if the given address is multicast.

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.

A multicast address applies to zero or more stations in a network and can be bridged to the extended network.

Callers of this macro can be running at any IRQL as long as the source address and supplied variable are resident.

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

Requirements

See also

FDDI_IS_BROADCAST

Send comments about this topic to Microsoft