|
| |
Find First Entry in Queue
|
Input |
Output |
| AX |
CBh |
05h |
Zero
/ -Error Code |
AX |
| BX |
|
|
Event
Handle for this File |
BX |
| CX |
Status
to Seek |
|
|
CX |
| DX |
Direction |
Queue |
|
|
DX |
Seek Status Codes: 0 - Event has successfully completed.
1 - Event is waiting to be processed.
2 - Number dialed or event in progress.
3 - Connection has been made -- sending.
4 - Connection has been made -- receiving.
5 - Event was aborted.
-1 Chooses an event without regard to status. This value will
probably be used most often.
Other negative values
Matches error codes in Control File.
Direction Flag: 0 - Search forward chronologically (from the first occurring
event to the last occurring event).
1 - Search backward chronologically (from the last occurring
event to the first occurring event).
Queue: 0 - Find first Control File in Task Queue.
1 - Find first Control File in Receive Queue.
2 - Find first Control File in Log Queue.
The Find First Entry in Queue function (05H) searches the queue you specify
in the DL register for an event whose status matches the one you specify in
the CX register. Entries in queues are ordered by the date and time in
which the corresponding events occurred (or are scheduled to occur).
Depending on the value you place in the DH register, the function searches
for the earliest or latest such event. The function returns a 15-bit event
handle of the entry it finds.
Once you use this function to obtain an event handle, you can access the
file associated with that event by calling the Open a File function (07H).
Use the Find Next Entry in Queue function (06H) to find subsequent entries
in the queue.
If the queue is empty, this function returns error code 204H (no more
events) in the AX register. Note that the number in register AX is the
negative (2's complement) of the error code (that is, FDFCH.)
See Also 06h 07h Error Codes |