IESRequestTunerEvent::GetPriority Method
[This documentation is preliminary and is subject to change.]
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
pbyPriority [out]
Gets a 1-byte code that indicates the priority. The code can be any of the following values.Value Meaning 0x00
OPPORTUNISTIC. The device that receives the request should see if the request conflicts with any other tuner usage, including scheduled and live viewing usages.
0x01
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.
0x02-0xFE
Reserved.
0xFF
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 the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
| Client | Requires Windows 7. |
| IDL | Declared in Tuner.idl. |
See Also
Send comments about this topic to Microsoft
Build date: 12/4/2008