RMCreateLDev

Syntax

RMCreateLDev(hDriver, hLDev, hAssocDevice, LDevStruct);

Parameters

hDriver (HDRIVER) - input

Driver handle of the device driver creating this adapter.

hLDev (PHLDEV) - output

Pointer to variable to receive the returned logical device handle.

hAssocDevice (HDEVICE) - input

Handle of the physical device or adapter that this logical device is aliasing.

Note: This field can also contain an adapter handle that was coerced to an HDEVICE type.

LDevStruct (PLDEVSTRUCT) - output

Pointer to the LDEVSTRUCT structure.

Return Code

rc (APIRET) - returns

On systems where the Resource Manager driver is not installed, the library interface code will return RMRC_SUCCESS and a logical device handle of -1L.

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_NULL_POINTER

A Resource Manager service received a NULL value for a pointer that was expected to contain a valid 16:16 address.

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.

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_OUT_OF_MEMORY

The Resource Manager is out of memory.

RMRC_RES_ALREADY_CLAIMED

The requested resource is allocated exclusively to another driver, or the requested sharing mode conflicts with the sharing mode of other owners of the resource.

Remarks

None.

Example Code

C

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

HDRIVER        hDriver;
PHLDEV         hLDev;
HDEVICE        hAssocDevice;
PLDEVSTRUCT    LDevStruct;
APIRET         rc;

rc = RMCreateLDev(hDriver, hLDev, hAssocDevice,
       LDevStruct);