FindFirstpgm Function

MDD File System Interface Library

MDDFS Interface Library Help
FindFirstpgm Function
C
int FindFirstpgm(
    const rom char * fileName, 
    unsigned int attr, 
    SearchRec * rec
);
Description

This function finds a file named with 'fileName' on PIC18. The FindFirstpgm function will copy a PIC18 ROM fileName argument into a RAM array, and then pass that array to the FindFirst function.

Preconditions

None

Parameters
Parameters 
Description 
fileName 
The name of the file to be found (ROM) 
attr 
The attributes of the file to be found 
rec 
Pointer to a search record to store the file info in 
Return Values
Return Values 
Description 
File was found 
-1 
No file matching the given parameters was found 
Side Effects

Search criteria from previous FindFirstpgm call on passed SearchRec object will be lost.The FSerrno variable will be changed.

Remarks

Call FindFirstpgm or FindFirst before calling FindNext. This function is for use with PIC18 when passing arguments in ROM.

Microchip MDD File System Interface 1.4.2 - [Oct 15, 2012]
Copyright © 2012 Microchip Technology, Inc.  All rights reserved.