Microsoft DirectX 8.1 (C++)

ICARequest::get_RequestedItem

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

The get_RequestedItem method retrieves the object that represents the requested service, for example, a tune request.

Syntax

HRESULT get_RequestedItem(
  IUnknown**  ppTunereq
);

Parameters

  ppTunereq

[out]  Pointer to a variable that receives a pointer to the requested item’s IUnknown interface.

Return Values

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

Remarks

The caller can query the returned IUnknown interface for more specific interfaces. Currently, tune requests are the only type of request object that is supported. Tune requests expose the ITuneRequest interface.

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

See Also