CLC_ErrorCode CHAI_CreateRemoteDevice	(	CPDEVICEID const *const	pDevID,
		CPHOOKEDOBJECT *const	phRemoteDevice
	)

Create a new Remote Device object from a DeviceID.

The application is notified when additional information such as parent and capabilities is available.

Parameters

[in]	pDevID	Pointer to the Device ID
[out]	phRemoteDevice	pointer 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. The NH_REMOTEDEVICE_READY callback MUST be set in the callback structure.

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.