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

IESRequestTunerEvent

Send comments about this topic to Microsoft

Build date: 12/4/2008