1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>SVC_InitSignHeap</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">SVC_InitSignHeap <IMG src="../image/BPT.gif" align="middle"><IMG src="../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <PRE><CODE>#include &lt;twl/os/common/systemCall.h&gt;</CODE></PRE>
16  <PRE><CODE>void SVC_InitSignHeap( SVCSignHeapContext* acmemory_pool,
17                         void* heap,
18                         unsigned int length );</CODE>
19
20<CODE>typedef struct
21{
22   u32* head;
23   u32* tail;
24   u32 size;
25}
26SVCSignHeapContext;
27
28</CODE></PRE>
29</DL>
30<H2>Arguments</H2>
31<TABLE border="1">
32  <TBODY>
33    <TR>
34      <TD><B><I>acmemory_pool</I></B></TD>
35      <TD>Information about the heap to configure. (Pointer to a <CODE>SVCSignHeapContext</CODE> structure)</TD>
36    </TR>
37    <TR>
38      <TD><B><I>heap</I></B></TD>
39      <TD>Pointer to the area to use as the heap.</TD>
40    </TR>
41    <TR>
42      <TD><B><I>length</I></B></TD>
43      <TD>Size of the area to use as the heap.</TD>
44    </TR>
45  </TBODY>
46</TABLE>
47<H2>Return Values</H2>
48<P>None.</P>
49<H2>Description</H2>
50<P>Sets the heap to use with the signature-related functions of the SVC library.</P>
51<P>The areas specified in <B><I>heap</I></B> and <B><I>length</I></B> are set as the heap to use with the signature-related functions of the SVC library. Data in the heap is stored in the <CODE>SVCSignHeapContext</CODE> structure indicated by <B><I>acmemory_pool</I></B>. Be sure to allocate an area in memory the size of the <CODE>SVCSignHeapContext</CODE> structure in advance, then specify that area in <B><I>acmemory_pool</I></B>.</P>
52<P>Be sure to specify areas 4 KB or greater in size for <B><I>heap</I></B> and <B><I>length</I></B>. There is no need for them to be aligned. </P>
53<H2>See Also</H2>
54<P><CODE><A href="SVC_DecryptRSA.html">SVC_DecryptRSA</A>, <A href="SVC_DecryptSign.html">SVC_DecryptSign</A>, <A href="SVC_DecryptSignDER.html">SVC_DecryptSignDER</A><BR></CODE></P>
55<H2>Revision History</H2>
56<P>2007/10/19 Initial version.</P>
57<hr><p>CONFIDENTIAL</p></body>
58</HTML>