OSID - osid.control.Input Service Interface Definition

Interface	osid.control.Input
Implements	`osid.OsidRelationship`
Used By	`osid.control.InputAdminSession`
	`osid.control.InputList`
	`osid.control.InputLookupSession`
Description	An `Input` is an `OsidRelationship` between a `Device` and a `Controller`. A `Controller` is the point of control or execution in a system while the `Device` is the presentation. For example, a joystick device has controllers for the stick and the firing buttons. The firing button controllers may also appear on a keyboard device. The `Input` describes how to interact with the `Controller` (photon torpedo) on the device (push button, press spacebar, etc.).
Method	getDeviceId
Description	Gets the device `Id`.
Return	`osid.id.Id`		the device `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getDevice
Description	Gets the device.
Return	`osid.control.Device`		the device
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getControllerId
Description	Gets the controller `Id`.
Return	`osid.id.Id`		the controller `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getController
Description	Gets the controller.
Return	`osid.control.Controller`		the controller
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getInputRecord
Description	Gets the input record corresponding to the given `Input` record `Type`.This method is used to retrieve an object implementing the requested record. The `inputRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(inputRecordType)` is `true`.
Parameters	`osid.type.Type`	`inputRecordType`	the type of input record to retrieve
Return	`osid.control.records.InputRecord`		the input record
Errors	NULL_ARGUMENT		`inputRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(inputRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.