| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The ICARequest interface is supported by requests.
A request is an attempt by the user to access a service. When the user tunes to a channel, a tune request is generated. In response, the Video Control calls the ICAManagerInternal::put_TuneRequest method on the Conditional Access (CA) Manager, passing in a pointer to the ITuneRequest interface. The CA Manager creates a new ICARequest object, which encapsulates the tune request. The CA Manager has a maximum of one active request at a time.
To retrieve the active request, call the ICAManager::get_ActiveRequest method. To get back the original ITuneRequest interface, call the ICARequest::get_RequestedItem method.
A request can have one or more components, which represent different streams within the same request. Components include audio streams, video streams, and auxiliary data streams. To retrieve the components in a request, call the ICARequest::get_Components method. For more information about components, see ICAComponent.
In addition to the methods inherited from IDispatch, the ICARequest interface exposes the following methods.
| Method | Description |
| get_CAManager | Retrieves the controlling CA Manager. |
| get_Check | Retrieves the number of components in this request that have at least one non-transient denial. |
| get_Components | Queries all of the existing policies for denials. |
| get_CountDeniedComponents | Retrieves the components of the request. |
| get_Denials | Retrieves the denials that apply to this request, if any. |
| get_RequestedItem | Retrieves the object that represents the requested service; for example, a tune request. |
| get_ResolveDenials | Attempts to resolve the denials associated with this request. |
| get_ScheduleEntry | Retrieves the schedule entry that corresponds to this request. |