DlnOpenDevice() Function

The DlnOpenDevice() function opens the specified device. This function uses an index number of the device. This number is randomly system-assigned to each connected device. It cannot be used to identify the device. If you need to open a specific device, use the DlnOpenDeviceBySn() or DlnOpenDeviceById() functions.

Syntax

C/C++

DLN_RESULT DlnOpenDevice(
   uint32_t deviceNumber,
   HDLN* deviceHandle
);

Parameters

deviceNumber: A number of the device.
deviceHandle: A pointer to the HDLN type variable that receives the device handle.

Return Value

DLN_RES_SUCCESS (0x00): The function successfully opened the DLN device.
DLN_RES_NOT_CONNECTED (0xA1): The library is not connected to any server.
DLN_RES_MEMORY_ERROR (0x86): Not enough memory to process this command.
DLN_RES_HARDWARE_NOT_FOUND (0x81): Invalid device number. To check the number of available devices, call the DlnGetDeviceCount() function.
DLN_RES_DEVICE_REMOVED (0x8E): The device was disconnected during the function execution.

Remarks

The DlnOpenDevice() function is defined in the dln_generic.h file.