PlateDroppedOff method

Description

VWorks software calls the PlateDroppedOff method to notify the plugin that a labware was dropped off at the location specified in the previous call to the MakeLocationAvailable method. (See “MakeLocationAvailable method” .) A call to this method also provides information about the labware that was dropped off.

IMPORTANT After VWorks software calls the MakeLocationAvailable method, it always calls the PlateDroppedOff, PlatePickedUp, or PlateTransferAborted method before making any other calls to the plugin. See “PlateDroppedOff method” , “PlatePickedUp method” , “PlateTransferAborted method” .

Syntax

 

HRESULT PlateDroppedOff( [in] BSTR PlateInfoXML, [out,retval] enum ReturnCode *retVal );

Parameters

 

PlateInfoXML	[in] A Plates XML block that contains information about the labware that was dropped off.
retVal	[out, retval] Returns an error code. Possible values: 0 = The request was completed (RETURN_SUCCESS) 1 = Something was wrong with the input, so the request was not completed (RETURN_BAD_ARGS) 2 = The request was not completed (RETURN_FAIL) For more information, see “ReturnCode enumerated type” .

PlateDroppedOff method input

VWorks software passes a Plates XML block into the PlateInfoXML parameter of the PlateDroppedOff method.

Plates XML block

The Plates XML block contains the Plates element and all its children. This XML block provides information about labware that are used in methods involving labware-handling processes.

XML structure

The Plates XML block does not contain a Velocity11 element.

Note: The MountedBy element is only present if the labware was involved in a Mount task.

 

<?xml version='1.0' encoding='ASCII' ?> <Plates> <Plate /> <Mountby /> </Plate> </Plates>

XML elements and attributes

See “Plates XML block components” .

Example of PlateDroppedOff method input

The following sample code is a Plates XML block that is received by the plugin from VWorks software as a string in the PlateInfoXML parameter of the PlateDroppedOff method. VWorks software tells the plugin that the labware named process ‑ 1 was dropped off at the location named Stage and that the labware was involved in a Mount task with the labware named process ‑ 3.

Note: The MountedBy element is only present if the labware was involved in a Mount task.

 

<?xml version='1.0' encoding='ASCII' ?> <Plates file='PlateInfo' md5sum='b9a7f88767ee8b4b2c70f62171222fea' version='1.0'> <Plate Instance_Number='1' Labware='1536 Black Greiner' Location='Stage' →Name='process - 1' Not_Really_Moving_The_Plate='0' Plate_Has_Lid='0' Simulating='0' →SourceDevice='PlatePad - 1' SourceLocation='Stage'> <MountedBy Instance_Number='1' Labware='1536 Black Greiner' Name='process - 3' →Plate_Has_Lid='0' /> </Plate> </Plates>

Related information

 

For information about...	See...
GetErrorInfo method	“GetErrorInfo method”
MakeLocationAvailable method	“MakeLocationAvailable method”
PlatePickedUp method	“PlatePickedUp method”
PlateTransferAborted method	“PlateTransferAborted method”
ReturnCode enumerated type	“ReturnCode enumerated type”