Microsoft DirectX 8.1 (C++)

IChannels::get_AddNewAt

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_AddNewAt method creates a new Channel object, adds it to this Channels collection at the index specified, and retrieves an interface to it.

Syntax

HRESULT get_AddNewAt(
  IService*  pservice,
  BSTR  bstrName,
  long  index,
  IChannel**  ppVal
);

Parameters

pservice

[in]  Specifies the IService interface of a Service object to be associated with the new Channel object.

bstrName

[in]  Specifies the name for the Channel object.

index

[in]  Specifies the index in the collection where the object is to be added.

ppVal

[out]  Address of a variable to receive a pointer to the IChannel interface of the retrieved object.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_OUTOFMEMORY There is not sufficient memory to create a new object.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

This method is valid only for the collection of objects returned by IChannelLineup::get_Channels, which is an ordered collection.

See Also