RMUpdateAdjunct

This rmcall service updates an existing adjunct structure.

Syntax

RMUpdateAdjunct(hDriver, hDevice, AdjunctIndex, AdjunctData);

Parameters

hDriver (HDRIVER) - input 

Driver handle of the device driver that created the adjunct data.

hDevice (HDEVICE) - input 

Device handle with which the adjunct data is associated.

AdjunctIndex (USHORT) - input 

Index to the adjunct structure to be replaced.

AdjunctData (PADJUNCT) - output 

Pointer to an adjunct structure containing replacement data for the adjunct indicated.

Return Code

rc (APIRET) - returns 

On systems where the Resource Manager driver is not installed, the library interface code will return RMRC_NOT_INSTALLED.

RMRC_IRQ_ENTRY_ILLEGAL 

A Resource Manager service was issued at interrupt time. The Resource Manager service request can be issued only at task time or INIT time.

RMRC_BAD_DRIVERHANDLE 

The expected Resource Manager handles were not provided because the handle was not a valid Resource Manager handle or the handle did not point to the type of object the service required.

RMRC_BAD_DEVICEHANDLE 

The expected Resource Manager handles were not provided because the handle was not a valid Resource Manager handle or the handle did not point to the type of object the service required.

RMRC_INVALID_PARM_VALUE 

A nonhandle or nonpointer variable contains an invalid or out-of-range value because:

• An invalid decode width was specified when allocating an I/O Port range.
• A handle search is being performed with cMaxHandles set to 0.

Remarks

For Resource Manager version 1.1, the size of the replacement adjunct structure must not exceed the size of the existing adjunct.

Example Code

C

#include <os2.h>
#include <rmcalls.h>

HDRIVER     hDriver;
HDEVICE     hDevice;
USHORT      AdjunctIndex;
PADJUNCT    AdjunctData;
APIRET      rc;

rc = RMUpdateAdjunct(hDriver, hDevice, AdjunctIndex, AdjunctData);