====== hfzHeader_EncodeExtHeaderBuf ======

===== Description =====

Encode the array of hfzExtHeaderBlock structs in a hfzHeader struct (see pExtHeaderBlocks member) into a byte array.

===== Function prototype =====

<code>long hfzHeader_EncodeExtHeaderBuf(hfzHeader &fh, char** ppBuf);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| fh | hfzHeader& | The hfzHeader struct containing the initialised array of hfzExtHeaderBlock structs (see //pExtHeaderBlocks// member) that shall be compiled into a byte array. |
| pBuf | char* | A handle to an uninitialised raw byte pointer, which shall be initialised and filled with the extended header by array by this function. |

===== Return value =====

The number of bytes taken by the compiled extended header (if 0 or greater), or otherwise an error code. Use [[libhfz:functions:hfzGetErrorStr]] to retrieve the error description. 

===== Comments =====

<note important>
This function is used internally within LibHFZ to encode the extended headers in HFZ/HF2 files. Developers would not normally need to use this function.
</note>