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:
| Value | Meaning |
|---|---|
|
Setup or scanning |
|
Playback for a user |
|
Picture in Picture (PIP) playback for a user |
|
User-directed recording |
|
Speculative recording |
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�7 [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | bdaiface.h |