IBDA_IPSinkInfo::get_MulticastList

 
Microsoft DirectShow 9.0

IBDA_IPSinkInfo::get_MulticastList

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(
  ULONG*  pulcbAddresses,
  BYTE**  ppbAddressList
);

Parameters

  pulcbAddresses

[out]  Receives the number of bytes in the returned array.

  ppbAddressList

[out, size_is(*pulcbAddresses)]  Pointer to variable that receives an array of bytes, of size *pulcbAddresses. Each IP address is 6 consecutive bytes.

Return Values

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

Header: Include bdaiface.h.

See Also