Framework Components Application Programming Interface (API)  fc-v07
ires_common.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2006-2012, Texas Instruments Incorporated
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * * Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  *
12  * * Redistributions in binary form must reproduce the above copyright
13  * notice, this list of conditions and the following disclaimer in the
14  * documentation and/or other materials provided with the distribution.
15  *
16  * * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
22  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
27  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  *
32  */
39 #ifndef IRES_COMMON_
40 #define IRES_COMMON_
41 
44 
45 
46 #ifdef __cplusplus
47 extern "C" {
48 #endif
49 
50 #include "ialg.h"
51 
52 
57 typedef enum IRES_Status {
58  IRES_OK = 0,
59  IRES_EALG = 1,
61  IRES_EFAIL = 3,
62  IRES_EINIT = 4,
67 } IRES_Status;
68 
73 typedef struct IRES_ProtocolRevision {
74  unsigned int Major;
75  unsigned int Source;
76  unsigned int Radius; /* Using unsigned int here to support
77  * xdc/std.h as well as tistdtypes.h
78  */
80 
81 
85 typedef enum IRES_RequestMode {
102 
103 
110 typedef struct IRES_ProtocolArgs {
111 
112  Int32 size;
118 
122 typedef struct IRES_ResourceDescriptor {
123 
127  String resourceName;
128 
137 
148 
155  struct IRES_Obj * handle;
156 
158 
168 typedef struct IRES_Properties {
169  Int32 size;
171 
176 typedef struct IRES_Obj {
177 
181  Int32 persistent;
182 
188  Void (*getStaticProperties) (struct IRES_Obj * resourceHandle,
189  IRES_Properties * resourceProperties);
190 
191 } IRES_Obj;
192 
196 typedef struct IRES_Obj *IRES_Handle;
197 
198 
199 
200 #ifdef __cplusplus
201 }
202 #endif /* extern "C" */
203 
206 #endif /* IRES_COMMON_ */
struct IRES_ProtocolArgs * protocolArgs
Pointer to the Resource Protocol Arguments.
Definition: ires_common.h:136
IRES_Status
IRES_Status defines the standard error and success codes returned by IRES APIs.
Definition: ires_common.h:57
Abstract Protocol Arguments structure definition. Actual arguments passed by the algorithm to request...
Definition: ires_common.h:110
struct IRES_Obj * IRES_Handle
Handle to "logical" resource.
Definition: ires_common.h:196
Void(* getStaticProperties)(struct IRES_Obj *resourceHandle, IRES_Properties *resourceProperties)
Definition: ires_common.h:188
Protocol revision type. Used to ensure the given 'protocol' revision can be validated.
Definition: ires_common.h:73
Definition: ires_common.h:94
Definition: ires_common.h:61
Int32 size
Definition: ires_common.h:112
Definition: ires_common.h:90
struct IRES_ResourceDescriptor IRES_ResourceDescriptor
Descriptor to Logical Resource.
Int32 size
Definition: ires_common.h:169
Int32 persistent
Definition: ires_common.h:181
Definition: ires_common.h:63
IRES_RequestMode mode
Definition: ires_common.h:113
IRES_Obj holds the private state associated with each logical resource.
Definition: ires_common.h:176
struct IRES_Properties IRES_Properties
Abstract Resource Properties structure/pointer definition. Actual resource protocol will supply the c...
struct IRES_ProtocolArgs IRES_ProtocolArgs
Abstract Protocol Arguments structure definition. Actual arguments passed by the algorithm to request...
struct IRES_Obj * handle
Definition: ires_common.h:155
This header defines all types, constants, and functions defined by XDAIS for algorithms.
unsigned int Radius
Definition: ires_common.h:76
struct IRES_Obj IRES_Obj
IRES_Obj holds the private state associated with each logical resource.
Definition: ires_common.h:58
Definition: ires_common.h:60
unsigned int Major
Definition: ires_common.h:74
Descriptor to Logical Resource.
Definition: ires_common.h:122
Definition: ires_common.h:59
IRES_ProtocolRevision * revision
The revision of the IRES_ResourceProtocol Interface expected by the client algorithm.
Definition: ires_common.h:147
unsigned int Source
Definition: ires_common.h:75
IRES_RequestMode
Mode in which resources can be requested.
Definition: ires_common.h:85
String resourceName
Definition: ires_common.h:127
struct IRES_ProtocolRevision IRES_ProtocolRevision
Protocol revision type. Used to ensure the given 'protocol' revision can be validated.
Definition: ires_common.h:86
Definition: ires_common.h:62
Definition: ires_common.h:65
Definition: ires_common.h:66
Abstract Resource Properties structure/pointer definition. Actual resource protocol will supply the c...
Definition: ires_common.h:168
Definition: ires_common.h:64
Copyright 2016, Texas Instruments Incorporated