D_VALID_ADDRESS

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

D_VALID_ADDRESS Selector

Parameter: devValidAddrParam * validaddr

The RIP calls this selector to ask the plugin whether a given Device Address is valid. The call is used by the Device Manager dialog as a check on what the user has entered. If the address is not valid, a report is issued, and the device is not instantiated.

If this selector is not implemented, the RIP assumes that any address is valid. The parameter passed with the selector is described below.

TEXT

    typedef struct devValidAddrParam {
      int32 v_valid;
      char *v_addr;
    } devValidAddrParam;

v_valid

Set this field to a non‐zero value to indicate that the address specified by v_addr is considered valid, and zero otherwise.

v_addr

A null‐terminated string containing the device address to be tested, as set in the Device Manager dialog.