Function libftd2xx_ffi::FT_OpenEx

source ·
pub unsafe extern "C" fn FT_OpenEx(
    pvArg1: PVOID,
    dwFlags: DWORD,
    pHandle: *mut FT_HANDLE
) -> FT_STATUS
Expand description

@noop FT_OpenEx @par Supported Operating Systems Linux Mac OS X (10.4 and later) Windows (2000 and later) Windows CE (4.2 and later) @par Summary Open the specified device and return a handle that will be used for subsequent accesses. The device can be specified by its serial number, device description or location. @n This function can also be used to open multiple devices simultaneously. Multiple devices can be specified by serial number, device description or location ID (location information derived from the physical location of a device on USB). Location IDs for specific USB ports can be obtained using the utility USBView and are given in hexadecimal format. Location IDs for devices connected to a system can be obtained by calling FT_GetDeviceInfoList or FT_ListDevices with the appropriate flags. @param pvArg1 Pointer to an argument whose type depends on the value of dwFlags. It is normally be interpreted as a pointer to a null terminated string. @param dwFlags FT_OPEN_BY_SERIAL_NUMBER, FT_OPEN_BY_DESCRIPTION or FT_OPEN_BY_LOCATION. @param pHandle Pointer to a variable of type FT_HANDLE where the handle will be stored. This handle must be used to access the device. @returns FT_OK if successful, otherwise the return value is an FT error code. @remarks The parameter specified in pvArg1 depends on dwFlags: if dwFlags is FT_OPEN_BY_SERIAL_NUMBER, pvArg1 is interpreted as a pointer to a null-terminated string that represents the serial number of the device; if dwFlags is FT_OPEN_BY_DESCRIPTION, pvArg1 is interpreted as a pointer to a nullterminated string that represents the device description; if dwFlags is FT_OPEN_BY_LOCATION, pvArg1 is interpreted as a long value that contains the location ID of the device. Please note that Windows CE and Linux do not support location IDs. @n ftHandle is a pointer to a variable of type FT_HANDLE where the handle is to be stored. This handle must be used to access the device.