DmiRegisterCiInd

The DmiRegisterCiInd block can be used as follows:

• To register a callable interface for components that have resident instrumentation code

• To get the version of the service layer.

The format for the command block is: ┌──────────────────────────────────────────────────────────────────────────────┐│Table44 .DmiRegisterCiIndCommandBlock │
├───────────────┬───────────────┬───────────────┬──────────────────────────────┤
│ OFFSET │ SIZE │ TYPE │ VARIABLE NAME │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 0 │ 64 │ STRUCT │ DmiMgmtCommand │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 68 │ 4 │ INT │ iComponentId │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 72 │ 4 │ PTR │ pAccessFunc │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 76 │ 4 │ PTR │ pCancelFunc │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 80 │ 4 │ INT │ iAccessListCount │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 84 │ 8 │ STRUCT │ DmiAccessData[ ] │
└───────────────┴───────────────┴───────────────┴──────────────────────────────┘

Variable Name

Variable Description

The command block. The value of iCommand is 0x400.

ID of the service layer assigned to the component on installation.

Pointer to the entry point of the component instrumentation. The service layer calls the component instrumentation with the C prototype:

unsigned long  pAccessFunc(PTR command)

The variable command is the complete block. A value of zero is illegal.

Pointer to the entry point that the service layer calls to cancel an outstanding operation through the direct interface. The service layer calls with the C prototype:

unsigned long  pCancelFunc(void)

A value of zero is illegal.

The number of blocks of type DmiAccessData, as defined in DmiAccessData Command Block.

The groups and individual attributes that use the direct interface. The format of the DmiAccessData block is defined in DmiAccessData Command Block.

The format of the DmiAccessData block is: ┌──────────────────────────────────────────────────────────────────────────────┐│Table45 .DmiAccessDataCommandBlock │
├───────────────┬───────────────┬───────────────┬──────────────────────────────┤
│ OFFSET │ SIZE │ TYPE │ VARIABLE NAME │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 0 │ 4 │ INT │ iGroupId │
├───────────────┼───────────────┼───────────────┼──────────────────────────────┤
│ 4 │ 4 │ INT │ iAttributeId │
└───────────────┴───────────────┴───────────────┴──────────────────────────────┘

Variable Name

Variable Description

Group that uses the direct interface. A value of zero indicates that all groups within this MIF file use the direct interface. In this case, the iAttributeId field is ignored.

Attributes, within the group specified by iGroupId, that use the direct interface. A value of zero indicates that all attributes within this group use the direct interface.

Issuing DmiRegisterCiInd displays an example of how to issue the DmiRegisterCiInd command to the CI. IssuingDmiRegisterCiInd

ULONG RegisterCI(ULONG ComponentID)
{
ULONG Size,x;
DMI_RegisterCiInd_t    *ciRegister;
ULONG RC = SLERR_OUT_OF_MEMORY;
DMI_MgmtCommand_t      *dmiCommand;
DMI_AccessData_t       *accessList;


   Size = (ULONG) (sizeof(DMI_RegisterCiInd_t) + (3 * sizeof(DMI_AccessData_t)));   // get size of block
   ciRegister = malloc(Size);
   if(ciRegister != (DMI_RegisterCiInd_t *)NULL){
       memset(ciRegister,0,Size);   // clear out the whole thing first
       dmiCommand = &(ciRegister->DmiMgmtCommand);
       dmiCommand->iLevelCheck = DMI_LEVEL_CHECK;
       dmiCommand->iCommand = DmiRegisterCiCmd;
       dmiCommand->iCmdLen = Size;
       dmiCommand->iCnfBufLen = 4000UL;
       dmiCommand->pCnfBuf = malloc(4000UL);

       ciRegister->iComponentId = ComponentID;          // assign the ID from install time
       ciRegister->pAccessFunc = DmiCiInvoke;           // invoke entry point into component code
       ciRegister->pCancelFunc = DmiCiCancel;           // Cancel entry point into component code
       ciRegister->iAccessListCount = 4;                // this example has four attributes in one group
       accessList = &(ciRegister->DmiAccessListφ0∙);
       for(x = 1;x != 5;x++){
           accessList->iGroupId = 2;                    // assign the group ID from the MIF
           accessList->iAttributeId = x;                // assign the attribute DI from the MIF
           accessList++;
       }
       RC = DmiInvoke((DMI_MgmtCommand_t *)ciRegister);
       free(ciRegister);
    }
    return RC;
}