Microsoft DirectX 8.1 (C++)

_ICAManagerEvents::RequestActivated

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

The RequestActivated method is called when the active request changes.

Syntax

HRESULT RequestActivated(
  ICARequest*  preq
);

Parameters

  preq

[in]  Pointer to the ICARequest interface of the new request.

Return Values

Return S_OK or an error code.

Remarks

Policies do not need to monitor this event. When a new request is activated through the ICAManagerInternal::put_TuneRequest method, the Conditional Access (CA) Manager calls the ICARequest::get_Check method, which iterates through the policies and calls the ICAPolicy::CheckRequest method on each policy. At that point, any policy can deny the request.

The dispatch identifier (dispid) of this method is 2201.

See Also