DevHelp QueueRead

This service returns and removes a character from the beginning of the specified character queue structure. If the queue is empty, an indicator is set.

Syntax

C

USHORT APIENTRY DevHelp_QueueRead (NPBYTE Queue, PBYTE Char)

Assembler

MOV   BX,OFFSET DS:queue      ; Points to the queue structure.
MOV   DL,DevHlp_QueueRead

CALL  [Device_Help]

Parameters

C

Queue (NPBYTE)

input - Near pointer to the queue structure to be initialized. (The Qsize field must be set up.)

Char (PBYTE)

input - Pointer to the character read from the queue.

Assembler

MOV   BX,OFFSET DS:queue      ; Points to the queue structure.

Return Code

C

Success Indicator: 0 - returns character read from the queue.

Assembler

   'C' Clear if successful.
       AL = the character read from the queue.

   'C' Set if the queue is empty.

Remarks

This function operates on the simple character queue structure initialized by QueueInit.

Example Code

C

#include  "dhcalls.h"

USHORT APIENTRY DevHelp_QueueRead (NPBYTE Queue,
                                   PBYTE Char)