Jump to content

DevHelp QueueWrite: Difference between revisions

From EDM2
Created page with "This service adds a character at the end of the specified character queue structure. If the queue is full, an indicator is set. ==Syntax== ===C=== BOOL DevHelp_QueueWrite (..."
 
Ak120 (talk | contribs)
mNo edit summary
 
Line 1: Line 1:
This service adds a character at the end of the specified character queue structure. If the queue is full, an indicator is set.  
{{DISPLAYTITLE:DevHelp_QueueWrite}}
This service adds a character at the end of the specified character queue structure. If the queue is full, an indicator is set.


==Syntax==
==Syntax==
Line 13: Line 14:
CALL  [Device_Help]
CALL  [Device_Help]
</PRE>
</PRE>
==Parameters==
==Parameters==
===C===
===C===
; Queue (NPBYTE) - input - Near pointer to the queue structure to be initialized. (The Qsize field must be set up.)
;Queue (NPBYTE) - input - Near pointer to the queue structure to be initialized. (The Qsize field must be set up.)
; Char (UCHAR) - input - Character to insert at the end of the queue.
;Char (UCHAR) - input - Character to insert at the end of the queue.


===Assembler===
===Assembler===
Line 25: Line 27:


==Return Code==
==Return Code==
===C===
===C===
Success Indicator: 0  - character is inserted at the end of the queue.
Success Indicator: 0  - character is inserted at the end of the queue.
Line 47: Line 48:
                         UCHAR Char)
                         UCHAR Char)
</PRE>
</PRE>
==Related Functions==


[[Category:DevHlps]]
[[Category:DevHlps]]

Latest revision as of 00:57, 8 October 2018

This service adds a character at the end of the specified character queue structure. If the queue is full, an indicator is set.

Syntax

C

BOOL DevHelp_QueueWrite (NPBYTE Queue, UCHAR Char)

Assembler

MOV   BX,OFFSET DS:queue      ; Points to the queue structure.
MOV   AL,char                 ; Character to insert at the end of the queue.
MOV   DL,DevHlp_QueueWrite

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 (UCHAR) - input - Character to insert at the end of the queue.

Assembler

MOV   BX,OFFSET DS:queue      ; Points to the queue structure.
MOV   AL,char                 ; Character to insert at the end of the queue.

Return Code

C

Success Indicator: 0 - character is inserted at the end of the queue.

Assembler

   'C' Clear if character stored successfully.

   'C' Set if queue is full.

Remarks

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

Example Code

C

#include  "dhcalls.h"

BOOL DevHelp_QueueWrite (NPBYTE Queue,
                         UCHAR Char)