DirList (FB; Prefix fildls)¶

FUNCTION_BLOCK DirList EXTENDS CBM.ETrig

This function reads directory entries. The function block needs a valid handle which identifies the directory as a transfer parameter. The information is written to structure ”deDirEntry” of type ”FILE_DIR_ENTRY”. If the function block cannot find any further entries the error message ”ERROR.NO_MORE_ENTRIES” is generated and the entries in the structure ”deDirEntry” are deleted.

InOut:

Scope	Name	Type	Comment	Inherited from
Input	xExecute	BOOL	Rising edge: Action starts Falling edge: Resets outputs If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (xDone, xError) are present at the outputs for exactly one cycle.	ETrig
Output	xDone	BOOL	TRUE: Action successfully completed	ETrig
	xBusy	BOOL	TRUE: Function block active	ETrig
	xError	BOOL	TRUE: Error occurred, function block aborts action FALSE: No error	ETrig
Input	hDir	CAA.HANDLE	Directory handle
Output	eError	ERROR	Local library error ID (5106 - FILE_NO_MORE_ENTRIES: no further entries available)
	deDirEntry	FILE_DIR_ENTRY	Directory entry