## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### PDALERTINFO Field - ulFlags

ulFlags (ULONG) Flags describing the returned alert structure.

This parameter must be set by the caller to the appropriate bits as defined below. If none of these values apply, the caller should set this field to 0 (zero).

PD_SNMP - 0x00000008 Set when InData is received from the SNMP channel.

PD_ALTERNATE - 0x00000010 Set when InData is received from the alternate command channel.

PD_NEXTALERT - 0x00001000 Set when the port driver is given a PD_MOREALERTS flag, set on the previous call to SplProtXlateCmd. When PD_NEXTALERT is set , pInData is not used; the protocol converter returns the next PRTALERT structure that it was unable to return to the last caller. If the protocol converter does not have any more alerts to return, it should return ERROR_ INFO_NOT_AVAIL.

On exit, the protocol converter sets some of the following bits. If all flags are clear, the protocol converter did not understand the data. The bits to be set are as follows:

PD_ALERT - 0x00000001 Set when the alert is returned.

PD_RESPONSE - 0x00000002 Set when a response to a query or set command is given.

PD_PARTIAL - 0x00000004 Set when not enough information is passed to create a full structure.

PD_IGNORE - 0x00000020 Set when the protocol converter handles the data and the data should not be passed on to the spooler.

PD_MOREALERTS - 0x00002000 Set when the data given to the protocol converter contains more than one alert. This flag should be set only when the PD_ALERT flag is also set.

PD_MOREALERTS signals the port driver that it should return the PRTALERT structure to the caller of BIDI_WAIT_ALERT. Then, when the port driver gets the next BIDI_WAIT_ALERT call, it should call SplProtXlateCmd with pInData and cbInData set to 0 (zero) and with the PD_NEXTALERT bit set.

When the protocol converter has returned all alerts for a given buffer, it must clear PD_MOREALERTS.