long osdDirectoryScan(char *dirname,char ***namelist,int (*select)(struct dirent *),int (*compare)(struct dirent **,struct dirent **))
The number of entries is returned.
A value less than 0 indicates an error occurred.
| dirname | full path name of the directory to be scanned |
| namelist | pointer to a double pointer into which an array of
character strings will be allocated and filled. It is the responsibility
of the calling process to make sure no existing allocations are previously
being referenced by this variable and that the allocated buffers are
freed after use. The function osdDirectoryListFree() is provided to
automatically free buffers referenced by namelist. |
| select | Reserved for future use; set to NULL.
Potentially, this will specify a user function to determine which files are included and excluded from the list. |
| compare | Reserved for future use; set to NULL.
Potentially, this will specify a user function to the ordering of the files in the list. |