Microsoft DirectX 8.1 (C++)

ICAManager::get_ActiveRequest

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

The get_ActiveRequest method retrieves the request that is currently active.

Syntax

HRESULT get_ActiveRequest(
  ICARequest**  ppRequest
);

Parameters

  ppRequest

[out]  Pointer to a variable that receives an ICARequest interface pointer, or NULL if there is no active request.

Return Values

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

Remarks

The request object encapsulates the most recent tune request. Each video control instance has at most one active tune request.

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

See Also