ns_GetNeuralData

 ns_GetNeuralData   Retrieves neural event data by index

    Usage:
       [ns_RESULT, Data] = 
                ns_GetNeuralData(hFile, EntityID, StartIndex, IndexCount)

    Description:
        Returns an array of timestamps for the neural events of the entity
        specified by EntityID and referenced by the file handle hFile.
        The index of the first timestamp is StartIndex and the requested
        number of timestamps is given by IndexCount.  The timestamps are
        returned in Data.

    Parameters:
        hFile       Handle/Indentification number to an open file.
        EntityID    Identification number of the entity in the data file.
        StartIndex  First index number of the requested Neural Events
                    timestamp.
        IndexCount  Number of timestamps to retrieve.

    Return Values:
        Data        Array of double precision timestamps.
        ns_RESULT   This function returns ns_OK if the file is successfully
                    opened. Otherwise one of the following error codes is 
                    generated:

                        ns_BADFILE      Invalid file handle passed to 
                                        function
                        ns_BADENTITY    Invalid or inappropriate entity 
                                        identifier specified
                        ns_BADINDEX     Invalid entity index specified
                        ns_FILEERROR    File access or read error

    Copyright (C) 2003 Neuroshare Project
    Author: Almut Branner
    Last modification: 8/11/2003