<HTML>

<HEAD>
<META HTTP-EQUIV="Content-Type" content="text/html; charset=iso-8859-1">
<TITLE>HP_ReadFingeringNumber</TITLE>
<STYLE>
#flush {margin-left: -10p; margin-right: -0p}
#buttonbar {color: white}
</STYLE>
</HEAD>

<BODY TOPMARGIN=0 BGPROPERTIES="FIXED" BGCOLOR="white">
<FONT FACE="ARIAL">
<SPAN ID="flush">
<A NAME="SEE ALSO">

<TABLE WIDTH="100%" COLS=2 BORDER=0 BGCOLOR="#000000">
<TR ALIGN=RIGHT>
<TD ALIGN=LEFT>
<IMG SRC="images/hpmidifile.gif" WIDTH="110" HEIGHT="33"  BORDER=0>
</TD>
<TD ALIGN=RIGHT VALIGN=TOP>
<FONT FACE="ARIAL" SIZE="2">
<A ID=buttonbar HREF="samples_max_phrase_mark.html">
<IMG SRC="images/u_prev.gif" WIDTH="71" HEIGHT="16"  BORDER=0 ALT="Previous Topic">
</A>
<A ID=buttonbar HREF="functions.html">
<IMG SRC="images/u_index.gif" WIDTH="47" HEIGHT="16"  BORDER=0 ALT="Index">
</A>
<A ID=buttonbar HREF="hp_insert_fingering_number.html">
<IMG SRC="images/u_next.gif" WIDTH="48" HEIGHT="16"  BORDER=0 ALT="Next Topic">
</A>
</FONT></TD><TD WIDTH=15></TD>
</TR>
</TABLE>

</A>
</SPAN>

<A HREF="functions.html"><H5>[all functions]</A></H5>
<H2><A NAME="HP_ReadFingeringNumber">HP_ReadFingeringNumber</A></H2>
To read the attributes of a Fingering Number event, identified by its index "id" in the eventlist.<BR>

<P>
<B>HP_MIDIFILE_API UINT </B><B> </B><B>HP_ReadFingeringNumber</B>
<BR><B>(</B><BR>
<B>HP_MIDIFILE_MODULE *</B><I>hphandle</I><B>,</B><BR>
<B>int </B><I>id</I><B>,</B><BR>
<B>int *</B><I>time</I><B>,</B><BR>
<B>unsigned char **</B><I>event_data</I><B>,</B><BR>
<B>int *</B><I>length</I><BR>
<B>);</B>
<BR>

<H3>Parameters</H3>
<TABLE>
<TR VALIGN=top><TD><I>hphandle</I></TD>
<TD>Pointer to a HP_MIDIFILE handle.<BR></TD>
<TR VALIGN=top><TD><I>id</I></TD>
<TD>The index of the eventlist of the Fingering Number event.<BR></TD>
<TR VALIGN=top><TD><I>time</I></TD>
<TD>Pointer, filled by the function with the time of the MIDI-event.<BR></TD>
<TR VALIGN=top><TD><I>event_data</I></TD>
<TD>A pointer filled by the function with an array of the data of the event.<BR></TD>
<TR VALIGN=top><TD><I>length</I></TD>
<TD>A pointer filled by the function with the number of bytes of the event data.<BR></TD>
</TABLE>

<H3>Return Value</H3>
Error code. On success the code HP_ERR_NONE.<BR>
See <A HREF="error_codes.html">Error codes</A>.<BR>

<H3>Remarks</H3>

The function allocates memory for the array event data. Destroy the data with "HP_Delete(data);" afterwards.

<H3>See Also</H3>
<A HREF="general_facts_stream_access.html">Stream Acess: General facts</A>
,
<A HREF="samples_fingering_number.html">Samples</A>

</BODY>
</HTML>
