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.
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 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.