ICARequest::get_Components

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

The get_Components method retrieves the components of the request. Components are individual streams within the requested service, such as audio, video, and auxiliary data.

Syntax

HRESULT get_Components(
  ICAComponents**  ppComponents
);

Parameters

  ppComponents

[out]  Pointer to a variable that receives an ICAComponents interface pointer.

Return Values

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

Remarks

This method returns the ICAComponents collection interface, which the caller can use to enumerate the components. Each component has its own denial collection. If the collection includes any non-transient denials, the component should not be rendered.

The returned ICADenials interface has an outstanding reference count. The caller must release the interface.

See Also

• ICARequest Interface