1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-159BDA2E-123C-52DF-9F8B-E058379EBFB8" xml:lang="en"><title>Interrupt::SetPriority()</title><shortdesc>The interrupt architecture supports the concept of adjustable interrupt

    13 priorities.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>The <xref href="GUID-E7A7083C-97B9-39B9-A147-4A6E314EE3A3.dita#GUID-E7A7083C-97B9-39B9-A147-4A6E314EE3A3/GUID-FA4CFED7-D694-399C-8F84-FA9FE3C3A171"><apiname>Interrupt::SetPriority()</apiname></xref> function can be used to

    15 implement adjustable interrupt priorities. </p>

    16 <p>The function takes the <xref href="GUID-76A30EC4-4B99-5471-9E80-F853C91485BC.dita#GUID-76A30EC4-4B99-5471-9E80-F853C91485BC/GUID-8E58F4C9-0290-55E0-A4FD-B6C2361BE205">Interrupt

    17 ID</xref> to identify the interrupt source, and a <xref href="GUID-7A2A43EC-6125-3BFE-834B-23C37F7B40D5.dita"><apiname>TInt</apiname></xref> value

    18 specifying the priority value. The meaning of the priority value is hardware

    19 and implementation dependent and is defined by the port. </p>

    20 <p>At its simplest, the function could be used to decide whether interrupts

    21 generate an IRQ or FIQ at the ARM. For hardware such as OMAP that supports

    22 interrupt priority in hardware, priorities can be modified through this function.

    23 If priority adjustment is not supported, or will not be implemented, <xref href="GUID-E7A7083C-97B9-39B9-A147-4A6E314EE3A3.dita#GUID-E7A7083C-97B9-39B9-A147-4A6E314EE3A3/GUID-FA4CFED7-D694-399C-8F84-FA9FE3C3A171"><apiname>Interrupt::SetPriority()</apiname></xref> should

    24 just return <xref href="GUID-F89DA3F0-2A48-3F9B-8F08-29350E92D0E4.dita"><apiname>KErrNotSupported</apiname></xref>. </p>

    25 </conbody></concept>