IBDA_UserActivityService::SetCurrentTunerUseReason method (bdaiface.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

Specifies the current tuner use reason for a Media Sink Device (MSD) in a Protected Broadcast Driver Architecture (PBDA) media graph. A current tuner use reason records the reason that the MSD is currently using the tuner on a Media Transform Device (MTD).

An MSD calls this method every time the current tuner use reason changes. For example, when an MSD starts a recording, it calls this method and sets the use reason as "user directed recording." An MSD must also call this method every time it sets a tuner device, even if the use reason has not changed.

Syntax

HRESULT SetCurrentTunerUseReason(
  [in] DWORD dwUseReason
);

Parameters

[in] dwUseReason

Specifies the tuner use reason. This is one of the following values:

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

See also

IBDA_UserActivityService