* #WIFI_DIRECT_ERROR_OPERATION_FAILED
* #WIFI_DIRECT_ERROR_NOT_PERMITTED
* @since_tizen 2.3
+ * @remarks The @a mac_address can be used only in the callback. To use outside, make a copy.
* @param[in] error_code The error code
* @param[in] discovery_state The discovery state
* @param[in] mac_address The MAC address of found peer
* #WIFI_DIRECT_ERROR_NOT_PERMITTED
* #WIFI_DIRECT_ERROR_CONNECTION_FAILED
* @since_tizen 2.3
+ * @remarks The @a mac_address can be used only in the callback. To use outside, make a copy.
* @param[in] error_code The error code
* @param[in] connection_state The connection state
* @param[in] mac_address The MAC address of the connection peer
/**
* @brief Called when the state of connection is changed.
- * @since_tizen 5.0
* @details The following error codes can be delivered:\n
* #WIFI_DIRECT_ERROR_NONE\n
* #WIFI_DIRECT_ERROR_OPERATION_FAILED\n
* #WIFI_DIRECT_ERROR_NOT_PERMITTED
+ * @since_tizen 5.0
* @param[in] error_code The error code
* @param[in] connection_state The connection state
* @param[in] data_s The structure for peer data
* #WIFI_DIRECT_ERROR_OPERATION_FAILED
* #WIFI_DIRECT_ERROR_NOT_PERMITTED
* @since_tizen 2.3
+ * @remarks The @a mac_address can be used only in the callback. To use outside, make a copy.
+ * The @a ip_address can be used only in the callback. To use outside, make a copy.
+ * The @a interface_address can be used only in the callback. To use outside, make a copy.
* @param[in] mac_address The MAC address of connection peer
* @param[in] ip_address The IP address of connection peer
* @param[in] interface_address The interface address of connection peer
* #WIFI_DIRECT_ERROR_OPERATION_FAILED
* #WIFI_DIRECT_ERROR_NOT_PERMITTED
* @since_tizen 2.3
+ * @remarks The @a mac_address can be used only in the callback. To use outside, make a copy.
* @param[in] error_code The error code
* @param[in] service_state The service discovery state
* @param[in] service_type Specifies the types of service
/**
- * @brief Registers the callback called when the state of device is changed.
+ * @brief Sets the callback called when the state of device is changed.
* @since_tizen 2.3
* @param[in] cb The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
- * @brief Unregisters the callback called when the state of device is changed.
+ * @brief Unsets the callback called when the state of device is changed.
* @since_tizen 2.3
* @return @c 0 on success,
* otherwise a negative error value
/**
- * @brief Registers the callback called when the state of discovery is changed.
+ * @brief Sets the callback called when the state of discovery is changed.
* @since_tizen 2.3
* @param[in] cb The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
- * @brief Unregisters the callback called when the state of discovery is changed.
+ * @brief Unsets the callback called when the state of discovery is changed.
* @since_tizen 2.3
* @return @c 0 on success,
* otherwise a negative error value
/**
- * @brief Registers the callback called when the peer is found.
+ * @brief Sets the callback called when the peer is found.
* @since_tizen 2.3
* @param[in] cb The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
- * @brief Unregisters the callback called when the peer is found.
+ * @brief Unsets the callback called when the peer is found.
* @since_tizen 2.3
* @return @c 0 on success,
* otherwise a negative error value
/**
- * @brief Registers the callback called when the state of connection is changed.
+ * @brief Sets the callback called when the state of connection is changed.
* @since_tizen 2.3
* @param[in] cb The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
- * @brief Unregisters the callback called when the state of connection is changed.
+ * @brief Unsets the callback called when the state of connection is changed.
* @since_tizen 2.3
* @return @c 0 on success,
* otherwise a negative error value
/**
- * @brief Registers the callback called when the IP address of the client is assigned
+ * @brief Sets the callback called when the IP address of the client is assigned
* if your device is the group owner.
* @since_tizen 2.3
* @param[in] cb The callback function to invoke
/**
- * @brief Unregisters the callback called when the IP address of the client is assigned
+ * @brief Unsets the callback called when the IP address of the client is assigned
* if your device is the group owner.
* @since_tizen 2.3
* @return @c 0 on success,
/**
- * @brief Registers the callback called when the state of the service discovery is changed.
+ * @brief Sets the callback called when the state of the service discovery is changed.
* @since_tizen 2.3
* @param[in] cb The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
- * @brief Unregisters the callback called when the state of the service discovery is changed.
+ * @brief Unsets the callback called when the state of the service discovery is changed.
* @since_tizen 2.3
* @return @c 0 on success,
* otherwise a negative error value
/**
- * @brief Registers the callback called when the state of Wi-Fi Direct is changed.
+ * @brief Sets the callback called when the state of Wi-Fi Direct is changed.
* @since_tizen 3.0
* @param[in] cb The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
/**
- * @brief Unregisters the callback called when the state of Wi-Fi Direct is changed.
+ * @brief Unsets the callback called when the state of Wi-Fi Direct is changed.
* @since_tizen 3.0
* @return @c 0 on success,
* otherwise a negative error value
/**
* @brief Starts discovery to find all P2P capable devices with specified channel, asynchronously.
- * @details If you call this function with @a channel as @c WIFI_DIRECT_DISCOVERY_FULL_SCAN
+ * @details If you call this function with @a channel as @c #WIFI_DIRECT_DISCOVERY_FULL_SCAN
* it works same as wifi_direct_start_discovery() API.
- * If application developers call this function with @a channel as @c WIFI_DIRECT_DISCOVERY_SOCIAL_CHANNEL,
+ * If application developers call this function with @a channel as @c #WIFI_DIRECT_DISCOVERY_SOCIAL_CHANNEL,
* then will search only the devices on the social channels(channel 1 or 6 or 11).
- * If application developers call this function with @a type as @c WIFI_DIRECT_DISCOVERY_CHANNEL1,
+ * If application developers call this function with @a channel as @c #WIFI_DIRECT_DISCOVERY_CHANNEL1,
* then will search only the devices on the channel 1.
- * If application developers call this function with @a type as @c WIFI_DIRECT_DISCOVERY_CHANNEL6,
+ * If application developers call this function with @a channel as @c #WIFI_DIRECT_DISCOVERY_CHANNEL6,
* then will search only the devices on the channel 6.
- * If application developers call this function with @a type as @c WIFI_DIRECT_DISCOVERY_CHANNEL11,
+ * If application developers call this function with @a channel as @c #WIFI_DIRECT_DISCOVERY_CHANNEL11,
* then will search only the devices on the channel 11.
* @since_tizen 2.3
* @privlevel public
/**
* @brief Cancels discovery process, asynchronously.
* @details This function stops all discovery processes started with
- * wifi_direct_start_discovery... functions.
+ * wifi_direct_start_discovery() functions.
* @since_tizen 2.3
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
/**
* @brief Connects to a specified peer, asynchronously.
- * @details This API connects to specified peer by automatically determining
+ * @details This function connects to specified peer by automatically determining
* whether to perform group formation, join an existing group, invite, re-invoke a group.
* The decision is based on the current state of the peers (i.e. GO, STA, not connected)
* and the availability of persistent data.
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
+ * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED Operation failed
* @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED Communication failed
* @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED Permission denied
/**
* @brief Creates a Wi-Fi Direct Group, asynchronously.
- * @details This API sets up device as the Group Owner and waits for clients to connect.
+ * @details This function sets up device as the Group Owner and waits for clients to connect.
* In addition, a soft AP will be created, the WPS registrar and the DHCP server will be started.
* @since_tizen 2.3
* @privlevel public
/**
* @brief Creates a Wi-Fi Direct Group, asynchronously with given SSID name.
- * @since_tizen 5.0
* @details This function sets up device as the Group Owner and waits for clients to connect.
* In addition, a soft AP will be created, the WPS registrar and the DHCP server will be started.
+ * @since_tizen 5.0
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
* @param[in] ssid Referred to as a network name, it is a name that identifies a wireless network
/**
* @brief Destorys the Wi-Fi Direct Group, asynchronously.
- * @details This API destroys the Wi-Fi Direct Group owned by a local device.
- * If creating a Group is in progress, this API cancels that creating.
+ * @details This function destroys the Wi-Fi Direct Group owned by a local device.
+ * If creating a Group is in progress, this function cancels that creating.
* @since_tizen 2.3
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
/**
- * @brief Gets SSID(Service Set Identifier) of a local device.
+ * @brief Gets SSID (Service Set Identifier) of a local device.
* @since_tizen 2.3
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
- * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED Operation failed
* @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED Communication failed
* @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED Permission denied
* @since_tizen 2.3
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
- * @param[out] wps_mode Supported wps mode for local device
+ * @param[out] wps_mode Supported WPS mode for local device
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
/**
- * @brief Called when you get the supported WPS(Wi-Fi Protected Setup) type repeatedly.
+ * @brief Called when you get the supported WPS (Wi-Fi Protected Setup) type repeatedly.
* @since_tizen 2.3
* @param[in] type The type of WPS
* @param[in] user_data The user data passed from the request function
* @since_tizen 2.4
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
- * @param passphrase new wpa password to set. Application must set the new password before.
- * @remarks a peer can connect to this group as Wi-Fi Infrastructured mode with a passphrase.
+ * @remarks A peer can connect to this group as Wi-Fi Infrastructured mode with a passphrase.
+ * @param[in] passphrase new wpa password to set. Application must set the new password before.
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
* @param[in] mode Describes the mode of connection. In case of TRUE \n
- * auto-connection will be taken care by framework
+ * auto-connection will be taken care by framework
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
/**
* @brief Called when you get the persistent groups repeatedly.
* @since_tizen 2.3
+ * @remarks The @a mac_address can be used only in the callback. To use outside, make a copy.
+ * The @a ssid can be used only in the callback. To use outside, make a copy.
* @param[in] mac_address The MAC address of the persistent group owner
* @param[in] ssid The SSID (Service Set Identifier) of the persistent group owner
* @param[in] user_data The user data passed from the request function
/**
- * @brief WiFi Direct Service Discovery will be started.
+ * @brief Starts wifi direct service discovery.
* @since_tizen 2.3
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
* @param[in] mac_address The MAC address of servicing device. A broadcast \n
- * will be sent when MAC is SET to ZERO
+ * will be sent when MAC is SET to ZERO
* @param[in] service_type Describes the type of service
* @return @c 0 on success,
* otherwise a negative error value
/**
- * @brief A service started for Wi-Fi Direct Service Discovery will be stopped.
+ * @brief Cancels an ongoing wifi direct service discovery.
* @since_tizen 2.3
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
* @param[in] mac_address The MAC address of servicing device. A broadcast \n
- * will be sent when MAC is SET to ZERO
+ * will be sent when MAC is SET to ZERO
* @param[in] service_type Describes the type of service
* @return @c 0 on success,
* otherwise a negative error value
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
- * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED Operation failed
* @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED Communication failed
* @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED Permission denied
/**
- * @brief This API shall disable Wi-Fi Display functionality & disable the support of WFD Information Element (IE).
+ * @brief Disables Wi-Fi Display functionality & disables the support of WFD Information Element (IE).
* @since_tizen 2.4
* @privlevel public
* @privilege http://tizen.org/privilege/wifidirect
* @return @c 0 on success,
* otherwise a negative error value
* @retval #WIFI_DIRECT_ERROR_NONE Successful
- * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED Operation failed
* @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED Communication failed
* @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED Permission denied
* @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY Device or resource busy
* @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
* @post wifi_direct_connection_state_changed_cb() will be invoked with
- * WIFI_DIRECT_GROUP_DESTROYED when there's no connected Group Client
+ * #WIFI_DIRECT_GROUP_DESTROYED when there's no connected Group Client
* if device is Group Owner and this feature is enabled.
* @see wifi_direct_activate()
* @see wifi_direct_create_group()