CLC_ErrorCode CHAI_RemoteDevice_FindFirst_Async	(	FindDeviceOptions const	options,
		CPDEVICEID const *const	pParentDevID,
		DeviceCapabilities const	includeDeviceCapabilities,
		DeviceCapabilities const	excludeDeviceCapabilities,
		InOutCapabilities const	includeInputCapabilities,
		InOutCapabilities const	excludeInputCapabilities,
		InOutCapabilities const	includeOutputCapabilities,
		InOutCapabilities const	excludeOutputCapabilities,
		CPUINT16 const	wBrandID,
		CPUINT16 const	wModelID,
		CPUINT32 const	dwDuplicateNumberFrom,
		CPUINT32 const	dwDuplicateNumberTo,
		CPUINT16 const	wModuleIDFrom,
		CPUINT16 const	wModuleIDTo,
		CPUINT32 const	dwClientContextData,
		CPHASYNC *const	phAsync
	)

Find the first device according the specified filtering arguments.

Parameters

[in]	options	Find options flags (FDO_XXX) combination. See FindDeviceOptions enumeration.
[in]	pParentDevID	Pointer to the Parent ID (not used if FDO_NoHierarchy is set)
[in]	includeDeviceCapabilities	Included device capabilities flags. Use DC_Any to keep all devices.
[in]	excludeDeviceCapabilities	Excluded device capabilities flags. Use DC_None to keep all devices.
[in]	includeInputCapabilities	Included input capabilities flags. Use IOC_Any to keep all devices.
[in]	excludeInputCapabilities	Excluded input capabilities flags. Use IOC_None to keep all devices.
[in]	includeOutputCapabilities	Included output capabilities flags. Use IOC_Any to keep all devices.
[in]	excludeOutputCapabilities	Excluded output capabilities flags. Use IOC_None to keep all devices.
[in]	wBrandID	Brand ID filter. Use 0xFFFF as wildcard.
[in]	wModelID	Model ID filter. Use 0xFFFF as wildcard.
[in]	dwDuplicateNumberFrom	First duplicate number. Use 0xFFFFFFFF as wildcard.
[in]	dwDuplicateNumberTo	Last duplicate number. Use 0xFFFFFFFF as wildcard.
[in]	wModuleIDFrom	First module ID. Use 0xFFFF as wildcard.
[in]	wModuleIDTo	Last module ID. Use 0xFFFF as wildcard.
[in]	dwClientContextData	Data passed back to the ARH_CHAI_REMOTEDEVICE_FIND callback handler.
[out]	phAsync	Pointer to the handle of the async operation.

Returns

Standard CHAILink Client return code. See CLC_ErrorCode enumeration.

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.