D_GEN_SECURITY_FEATURE_NUMBER (core module plugins)

This page applies to Harlequin v13.1r0 and later; and to Harlequin MultiRIP but not Harlequin Core

D_GEN_SECURITY_FEATURE_NUMBER Selector

Parameter: devSecurityFeatureNumberParam * SecurityFeatureNumberParam

The RIP or the plugin may require an LDK feature before enabling the use of a plugin, as described for D_GEN_PASSWORD_PROTECTED (core module plugins) . Implementing this selector allows you to choose the LDK feature used to protect the device and possibly to reduce the number of features required when enabling related devices.

When the security device or a prior call to D_GEN_PASSWORD_PROTECTED indicates that the plugin is protected, the RIP calls this selector: once for each plugin to determine the requirements of a single device plugin, or once for each device type supported by a multiple device type plugin.

The possibilities are:

The plugin does not support this selector.
The plugin or device type can return an LDK feature number that the RIP will use when checking if the device is enabled.

If a plugin is protected, but this selector is not implemented, the RIP consults a built‐in table to lookup the LDK feature number to use. Note that this lookup will fail for a plugin which is newer than the RIP, meaning that the plugin will be unusable. Therefore, all new protected plugins should implement this selector.

The RIP's table will cover all existing protected plugins, so existing plugins do not need to be modified to implement this selector in order to work with an LDK enabled RIP. If a plugin implements this selector, its LDK feature number overrides any value in the RIP's table.

If the plugin supports this selector, the RIP will call it once for every module implemented by the plugin, after calling D_FIND_DEVICE . At this point the d_capabilities field of the deviceDefinition is not filled in, so the plugin must remember the device identifier itself if the same names are not being used for all of the devices in the plugin.

If this selector returns NOERR , the plugin has a feature number, returned using the parameter described here:

TEXT

      typedef struct devSecurityFeaatureNumberParam { uint32 nFeatureNumber;
    } devSecurityFeatureNumberParam;

Each distinct value of this parameter should correspond one‐to‐one with the option names returned by the D_GEN_SECURITY_NAME selector, so that a different LDK feature is required to enable the plugins or device types corresponding to each entry in the Configure RIP Extras dialog box in the RIP.

The LDK feature numbers to use are allocated by Global Graphics, so as to avoid a clash between two plugins choosing to use the same number. You should use your usual support channel if you want to be allocated feature numbers.

To ensure the security of your plugin, you must also supply a copy of the plugin file so that Global Graphics can protect the plugin against subsequent tampering, and then return the protected plugin to you for issue to your customers.