Microsoft DirectX 8.1 (C++)

IService::putref_TuneRequest

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

The putref_TuneRequest method specifies a TuneRequest object to be associated with this Service object.

Syntax

HRESULT put_TuneRequest(
  IUnknown*  punk
);

Parameters

punk

[in]  Specifies the IUnknown interface of the TuneRequest object.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

The actual TuneRequest object is stored in the database, because simply storing a pointer to its IUnknown interface would be meaningless. The storage mechanism obtains the IPersistStream interface of the TuneRequest object and then calls OleSaveToStream to write the binary image of the object to the stream. TuneRequest objects are small enough to make this feasible.

See Also