CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode CHAI_CreateRemoteDeviceFromLocalDevice ( CPHOBJECT const  hLocalDevice,
CPHOOKEDOBJECT *const  phRemoteDevice 
)

Create a new Remote Device object from a local device.

Parameters
[in]hLocalDeviceThe local device handle
[out]phRemoteDevicepointer to the remote device handle. CPHHOOKEDOBJECT_NULL if failed
Returns
Standard CHAILink Client return code. See CLC_ErrorCode enumeration.
Remarks
The returned handle must be released using HookedObject_Release function once useless. Note that the NH_REMOTEDEVICE_READY callback is not called for this function.
Warning
This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.