Previous

Next

Function RTUFindInterface

RTUFindInterface returns a pointer to an interface descriptor which matches certain criteria:

const RTUInterfaceDescriptor *  
   RTUFindInterface(RTUDeviceHandle Device, 
                    int             Class, 
                    int             SubClass, 
                    int             Protocol, 
                    int             Index, 
                    const RTUConfigurationDescriptor * * Config);

Parameters

Device

Device handle passed to an attachment/detachment callback.

Class

The interface's class code to search. If this parameter is -1, any class code is accepted.

SubClass

The interface's subclass code to search. If this parameter is -1, any subclass code is accepted.

Protocol

The interface's protocol code to search. If this parameter is -1, any protocol code is accepted.

Index

Zero-based index of the interface to return. Since several interface descriptors might match the criteria Class, SubClass, and Protocol, parameter Index specifies how many matching descriptors shall be skipped.

Config

Pointer to a pointer to the configuration descriptor within which the interface was found. *Config must be supplied in a call to RTUClaimInterface for the returned interface to become available.

return value

Pointer to the desired interface descriptor or NULL if no match is found. See function RTUGetInterface for details.

RTUFindInterface scans through all configurations and interfaces of the device. It is intended for clients which are only interested in specific interfaces. Note that only interfaces within a single configuration can be used. The first call to RTUClaimInterface determines which configuration will be used.

Device Query

Function RTUGetInterface

Function RTUGetEndpoint