Microsoft DirectX 9.0

IBDA_IPSinkInfo::get_MulticastList

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]  Pointer to a variable that 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.

See Also