Microsoft DirectX 8.1 (C++)

ICAManagerInternal::put_TuneRequest

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

The put_TuneRequest method specifies a new tune request. The Conditional Access (CA) Manager creates a new ICARequest object to encapsulate the tune request.

Syntax

HRESULT put_TuneRequest(
  ITuneRequest*  ptunereq
);

Parameters

  ptunereq

[in]  Pointer to the ITuneRequest interface of the tune request.

Return Values

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

Remarks

This method deactivates the current request, if any, and triggers the _ICAManagerEvents::RequestDeactivated and _ICAManagerEvents::RequestActivated events.

This method does not initiate any tuning operations in the Video Control. It simply creates an ICARequest object, which the CA Manager users to wrap the ITuneRequest object, and updates the CA Manager’s object hierarchy.

See Also