FFCreateDevice(_:_:)
Creates a new API device object from an OS object in preparation to use the device for force feedback.
Declaration
func FFCreateDevice(_ hidDevice: io_service_t, _ pDeviceReference: UnsafeMutablePointer<FFDeviceObjectReference?>!) -> HRESULTParameters
- hidDevice:
Pointer to a HID device object.
- pDeviceReference:
Address of a variable to receive an opaque reference handle to a new device object. This reference can be used in subsequent calls to FFDevice* functions
Return Value
If the method succeeds, and the device supports FF, the return value is FF_OK. If the method fails, the return value can be one of the following error values:
Discussion
FFERR_INVALIDPARAM
FFERR_NOINTERFACE
FFERR_OUTOFMEMORY
FFERR_INTERNAL
Discussion
When you are finished with the device, FFReleaseDevice must be called on the reference received in this function to dispose of the API device object.
See Also
Miscellaneous
FFDeviceCreateEffect(_:_:_:_:)FFDeviceEscape(_:_:)FFDeviceGetForceFeedbackCapabilities(_:_:)FFDeviceGetForceFeedbackProperty(_:_:_:_:)FFDeviceGetForceFeedbackState(_:_:)FFDeviceReleaseEffect(_:_:)FFDeviceSendForceFeedbackCommand(_:_:)FFDeviceSetCooperativeLevel(_:_:_:)FFDeviceSetForceFeedbackProperty(_:_:_:)FFEffectDownload(_:)FFEffectEscape(_:_:)FFEffectGetEffectStatus(_:_:)FFEffectGetParameters(_:_:_:)FFEffectSetParameters(_:_:_:)FFEffectStart(_:_:_:)