IESRequestTunerEvent::GetPriority method (tuner.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.]
Gets a code that indicates the priority of a device request for exclusive access to a tuner and its Conditional Access Services (CAS).
Syntax
HRESULT GetPriority(
[out, retval] BYTE *pbyPriority
);
Parameters
[out, retval] pbyPriority
Gets a 1-byte code that indicates the priority. The code can be any of the following values.
Value | Meaning |
---|---|
|
OPPORTUNISTIC. The device that receives the request should see if the request conflicts with any other tuner usage, including scheduled and live viewing usages. |
|
NOTIFY. The device that receives the request should check to see if the request conflicts with any other scheduled usage. If the acquisition conflicts with live viewing, the device should prompt the user before relinquishing access. |
|
Reserved. |
|
IMMEDIATE. The device that receives the request must release the tuner for the requestor ownership within the next 60 seconds. The requestor can forcibly acquire the tuner after 60 seconds. |
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 | tuner.h |