01.06.2013 Views

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

CX<br />

File attribute<br />

DS:DX<br />

Null terminated file specification (may include path and wildcards)<br />

Return Value<br />

Comments<br />

Success: Carry flag cleared, search results are in DTA<br />

Failure: Carry flag set<br />

The main task of your application has a standard pointer to a Disk Transfer Area of the program. This<br />

DTA address should be set with interrupt 0x21 function 0x1A before calling this findfirst function.<br />

The findfirst/findnext sequence is handled by your compiler library so the Disk Transfer Area is<br />

therefore not described here.<br />

Tasks created with the <strong>RTOS</strong> API inside of your application use a DTA from an internal list. A task<br />

which gets access to the file system reserves an entry in this list.<br />

Only ten DTA entries for user tasks are available.<br />

Related Topics<br />

Top of list<br />

Index page<br />

Find next file<br />

<strong>RTOS</strong> RTX_ACCESS_FILESYSTEM Service<br />

Fast Findfirst file<br />

Interrupt 0x21 service 0x4F: Find Next File<br />

Finds the next file in the findfirst/findnext sequence. The results are stored in the Disk Transfer<br />

Area (DTA).<br />

Parameters<br />

AH<br />

0x4F<br />

Return Value<br />

Comments<br />

Success: Carry flag cleared, search results are in DTA<br />

Failure: Carry flag set<br />

The task that calls findnext must be the same task that called findfirst.<br />

Since the entire state of a findfirst/findnext sequence is held in the DTA data block, other disk<br />

Page 274 / 400

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!