User`s guide

40 DC 900-1343D

DDCMP Programmer’s Guide

2.5 Overview of DDCMP Requests using Raw dlWrite

For DDCMP the dlWrite function supports three dlWrite categories: commands,

report requests, and data transfer, which are discussed in detail in Section 2.5.1 through

Section 2.5.3. Whether you use blocking or non-blocking I/O, each

dlWrite request

must be followed by a

dlRead request to receive the command conﬁrmation, the report

requested, or the acknowledgment of the data transfer. Section 2.6 discusses these dif-

ferent responses received using

dlRead.

In a DDCMP application, the

dlWrite requests must use Raw operation; that is, the

optional arguments structure (page 37) is required to specify protocol-speciﬁc infor-

mation.

Table 2–7 shows the DDCMP DLI request codes for different categories of the

dlWrite

function. Each request is explained in the following sections. An unsuccessful dlWrite

request can return one of the following error codes in the dlRead pOptArgs.iICPStatus

ﬁeld (see Appendix A for error handling):

DLI_ICP_ERR_INBUF_OVERFLOW

Input buffer overﬂow

DLI_ICP_ERR_OUTBUF_OVERFLOW

Output buffer overﬂow

Table 2–7: Categories for DDCMP dlWrite Requests