IBDA_EthernetFilter::GetMulticastList

 
Microsoft DirectShow 9.0

IBDA_EthernetFilter::GetMulticastList

The GetMulticastList method retrieves the list of multicast addresses on the Network Provider.

Syntax

  HRESULT GetMulticastList(
  ULONG*  ulcbAddresses,
  BYTE   pAddressList []
);

Parameters

  ulcbAddresses

[in, out]  On input, specifies the maximum number of addresses to retrieve, multiplied by the number of bytes per address. On output, receives the actual number of bytes retrieved.

  pAddressList

[out, size_is(ulcbAddresses)]  Pointer that receives an array of addresses whose size in bytes is equal to ulcbAddresses. See Remarks.

Return Values

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

Remarks

The declaration of pAddressList is not COM compliant. As a workaround, the client should allocate the pAddressList buffer. The buffer should be the same size as advertised in the pulcbAddresses parameter. The network provider will just fill in the buffer allocated by the caller.

Requirements

Header: Include bdaiface.h.

See Also