RMConvertID

This service is supported by both rminfo.dll and rmcalls.lib. It either converts a device ID to a string or it converts a string to device ID. For example, the device ID 0x32A0D041 is equivalent to the string "PNPA032".

Syntax

RMConvertID(pID, String, Direction);

Parameters

pID (PULONG) - output

The integer value of the device ID. The following are possible values:

  Bits[15:0]
       Three character compressed ASCII EISA ID.

  Bits[31:16]
       Manufacturer-specific function number and revision. 

String (PSZ) - output

This is a pointer to a 9 character-long string array.

Direction (USHORT) - output

Can be one of the following values:

       RM_CONVERT_TO_TEXT
       RM_CONVERT_TO_ID 

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_INVALID_PARM_VALUE
   RMRC_SUCCESS

Example Code

C

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

PULONG    pID;
PSZ       String;
USHORT    Direction;
APIRET    rc;

rc = RMConvertID(pID, String, Direction);