Share via


IBDA_IPSinkInfo::get_MulticastList method (bdaiface.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

This interface is available for use in the Microsoft Windows 2000, Windows XP, and Windows Server 2003 operating systems. It may be altered or unavailable in subsequent versions.

The get_MulticastList method retrieves a list of the multicast addresses to which the IP Sink filter is listening. This method returns a list of IP addresses in 6-byte IEEE 802.3 format; the list is returned as an array of bytes.

Syntax

HRESULT get_MulticastList(
  [out] ULONG *pulcbAddresses,
  [out] BYTE  **ppbAddressList
);

Parameters

[out] pulcbAddresses

Receives the number of bytes in the returned array.

[out] ppbAddressList

Pointer to variable that receives an array of bytes, of size *pulcbAddresses. Each IP address is 6 consecutive bytes.

Return value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

The method allocates the memory for the array. The caller must free the memory by calling CoTaskMemFree.

Requirements

Requirement Value
Target Platform Windows
Header bdaiface.h

See also

Error and Success Codes

IBDA_IPSinkInfo Interface