| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The get_Check method queries all of the existing policies for denials.
Syntax
HRESULT get_Check(
long* pcDenials
);
Parameters
pcDenials
[out] Pointer to a variable that receives the total number of denials on the request, and all of its components.
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
The Video Control calls this method after it receives a new tune request. The method first removes all existing denials from the request, and from the components of the request. Then it queries each policy by calling the ICAPolicy::CheckRequest method. The policies should add any appropriate denials at that time. They can add denials to the request or to components of the request.
The pcDenials parameter receives the total number of denials that were added. To retrieve denials on the request, call the ICARequest::get_Denials method. To retrieve denials on components, call the ICARequest::get_Components method, and then call ICAComponent::get_Denials on each component. If any components have denials, the ICARequest::get_CountDeniedComponents method returns a value greater than zero.
This method causes the _ICARequestEvents::CheckStarted and _ICARequestEvents::CheckComplete events to fire.
See Also