Diff: iothub_transport_ll.h

Revision:

40:1a94db9139ea

Parent:

38:a05929a75111

Child:

43:038d8511e817

--- a/iothub_transport_ll.h	Sun Apr 24 16:40:16 2016 -0700
+++ b/iothub_transport_ll.h	Mon May 09 14:37:02 2016 -0700
@@ -13,18 +13,32 @@
 {
 #endif
 
-typedef void* TRANSPORT_LL_HANDLE;
-typedef void* IOTHUB_DEVICE_HANDLE;
+	/** @brief	This struct captures device configuration. */
+	typedef struct IOTHUB_DEVICE_CONFIG_TAG
+	{
+		/** @brief	A string that identifies the device. */
+		const char* deviceId;
+
+		/** @brief	The device key used to authenticate the device. */
+		const char* deviceKey;
+
+		/** @brief	The device SAS used to authenticate the device in place of using the device key. */
+		const char* deviceSasToken;
 
-typedef IOTHUB_CLIENT_RESULT(*pfIoTHubTransport_SetOption)(TRANSPORT_LL_HANDLE handle, const char *optionName, const void* value);
-typedef TRANSPORT_LL_HANDLE(*pfIoTHubTransport_Create)(const IOTHUBTRANSPORT_CONFIG* config);
-typedef void (*pfIoTHubTransport_Destroy)(TRANSPORT_LL_HANDLE handle);
-typedef IOTHUB_DEVICE_HANDLE(*pfIotHubTransport_Register)(TRANSPORT_LL_HANDLE handle, const char* deviceId, const char* deviceKey, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, PDLIST_ENTRY waitingToSend);
-typedef void(*pfIotHubTransport_Unregister)(IOTHUB_DEVICE_HANDLE deviceHandle);
-typedef int (*pfIoTHubTransport_Subscribe)(IOTHUB_DEVICE_HANDLE handle);
-typedef void (*pfIoTHubTransport_Unsubscribe)(IOTHUB_DEVICE_HANDLE handle);
-typedef void (*pfIoTHubTransport_DoWork)(TRANSPORT_LL_HANDLE handle, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle);
-typedef IOTHUB_CLIENT_RESULT(*pfIoTHubTransport_GetSendStatus)(IOTHUB_DEVICE_HANDLE handle, IOTHUB_CLIENT_STATUS *iotHubClientStatus);
+	} IOTHUB_DEVICE_CONFIG;
+
+	typedef void* TRANSPORT_LL_HANDLE;
+	typedef void* IOTHUB_DEVICE_HANDLE;
+
+	typedef IOTHUB_CLIENT_RESULT(*pfIoTHubTransport_SetOption)(TRANSPORT_LL_HANDLE handle, const char *optionName, const void* value);
+	typedef TRANSPORT_LL_HANDLE(*pfIoTHubTransport_Create)(const IOTHUBTRANSPORT_CONFIG* config);
+	typedef void (*pfIoTHubTransport_Destroy)(TRANSPORT_LL_HANDLE handle);
+	typedef IOTHUB_DEVICE_HANDLE(*pfIotHubTransport_Register)(TRANSPORT_LL_HANDLE handle, const IOTHUB_DEVICE_CONFIG* device, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, PDLIST_ENTRY waitingToSend);
+	typedef void(*pfIotHubTransport_Unregister)(IOTHUB_DEVICE_HANDLE deviceHandle);
+	typedef int (*pfIoTHubTransport_Subscribe)(IOTHUB_DEVICE_HANDLE handle);
+	typedef void (*pfIoTHubTransport_Unsubscribe)(IOTHUB_DEVICE_HANDLE handle);
+	typedef void (*pfIoTHubTransport_DoWork)(TRANSPORT_LL_HANDLE handle, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle);
+	typedef IOTHUB_CLIENT_RESULT(*pfIoTHubTransport_GetSendStatus)(IOTHUB_DEVICE_HANDLE handle, IOTHUB_CLIENT_STATUS *iotHubClientStatus);
 
 #define TRANSPORT_PROVIDER_FIELDS                            \
 pfIoTHubTransport_SetOption IoTHubTransport_SetOption;       \
@@ -37,10 +51,10 @@
 pfIoTHubTransport_DoWork IoTHubTransport_DoWork;             \
 pfIoTHubTransport_GetSendStatus IoTHubTransport_GetSendStatus  /*there's an intentional missing ; on this line*/ \
 
-typedef struct TRANSPORT_PROVIDER_TAG
-{
-    TRANSPORT_PROVIDER_FIELDS;
-}TRANSPORT_PROVIDER;
+	typedef struct TRANSPORT_PROVIDER_TAG
+	{
+		TRANSPORT_PROVIDER_FIELDS;
+	}TRANSPORT_PROVIDER;
 
 #ifdef __cplusplus
 }