(v13) D_GETDOOBRIS

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

D_GETDOOBRIS Selector

Parameter: PluginDoobriQuery * doobriquery

After the plugin returns a dialog description in a PluginDialogDefinition , the RIP asks the plugin to fill in an array of Doobri structures associated with the dialog.

The call is not made if nDoobris in the PluginDialogDefinition is set to zero.

TEXT

    typedef struct PluginDoobriQuery {
        int32 dialogID;
        Doobri *pdoobri;
        struct devSelectDeviceParam *pdsdp
    } PluginDoobriQuery;

dialogID

The RIP fills this in with the identifier of the dialog concerned, as returned from a previous D_GETDLGDEFN in the PluginDialogDefinition structure.

pdoobri

This is a pointer to an array of Doobri structures. See (v13) The Doobri structure.

The RIP will already have allocated memory based on the number of Doobri structures (nDoobris) in the PluginDialogDefinition returned by D_GETDLGDEFN . The plugin should copy its array of doobris into this memory.

pdsdp

This is a pointer to a devSelectDeviceParam structure identifying the device in a multiple‐device output plugin that the request is for.

Note: The request may not be for the current device, because a dialog may be opened for one device while output to another continues.

Note: Do not assign to the pointer pdsdp.

This pointer should be ignored by input and single‐device output plugins.