Implement PPB_DeviceRef_Dev.

This is part of the work to suppport enumeration of multiple audio/video capture devices.

Relevant changes:
The thread that discussed interface design - http://codereview.chromium.org/8981009/
PPB_ResourceArray_Dev (committed) - http://codereview.chromium.org/9111008/

BUG=None
TEST=None


Review URL: http://codereview.chromium.org/9192019

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@118611 0039d316-1c4b-4281-b951-d872f2087c98

1 files changed, 86 insertions, 0 deletions

diff --git a/ppapi/c/dev/ppb_device_ref_dev.h b/ppapi/c/dev/ppb_device_ref_dev.h
new file mode 100644
index 0000000..7381880
--- /dev/null
+++ b/ppapi/c/dev/ppb_device_ref_dev.h
@@ -0,0 +1,86 @@
+/* Copyright (c) 2012 The Chromium Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+/* From dev/ppb_device_ref_dev.idl modified Fri Jan 20 12:58:06 2012. */
+
+#ifndef PPAPI_C_DEV_PPB_DEVICE_REF_DEV_H_
+#define PPAPI_C_DEV_PPB_DEVICE_REF_DEV_H_
+
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/pp_var.h"
+
+#define PPB_DEVICEREF_DEV_INTERFACE_0_1 "PPB_DeviceRef(Dev);0.1"
+#define PPB_DEVICEREF_DEV_INTERFACE PPB_DEVICEREF_DEV_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPB_DeviceRef_Dev</code> interface.
+ */
+
+
+/**
+ * @addtogroup Enums
+ * @{
+ */
+/**
+ * Device types.
+ */
+typedef enum {
+  PP_DEVICETYPE_DEV_INVALID = 0,
+  PP_DEVICETYPE_DEV_AUDIOCAPTURE = 1,
+  PP_DEVICETYPE_DEV_VIDEOCAPTURE = 2
+} PP_DeviceType_Dev;
+PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_DeviceType_Dev, 4);
+/**
+ * @}
+ */
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+struct PPB_DeviceRef_Dev_0_1 {
+  /**
+   * Determines if the provided resource is a device reference.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to a generic
+   * resource.
+   *
+   * @return A <code>PP_Bool</code> that is <code>PP_TRUE</code> if the given
+   * resource is a device reference, otherwise <code>PP_FALSE</code>.
+   */
+  PP_Bool (*IsDeviceRef)(PP_Resource resource);
+  /**
+   * Gets the device type.
+   *
+   * @param[in] device_ref A <code>PP_Resource</code> corresponding to a device
+   * reference.
+   *
+   * @return A <code>PP_DeviceType_Dev</code> value.
+   */
+  PP_DeviceType_Dev (*GetType)(PP_Resource device_ref);
+  /**
+   * Gets the device name.
+   *
+   * @param[in] device_ref A <code>PP_Resource</code> corresponding to a device
+   * reference.
+   *
+   * @return A <code>PP_Var</code> of type <code>PP_VARTYPE_STRING</code>
+   * containing the name of the device if successful; a <code>PP_Var</code> of
+   * type <code>PP_VARTYPE_UNDEFINED</code> if failed.
+   */
+  struct PP_Var (*GetName)(PP_Resource device_ref);
+};
+
+typedef struct PPB_DeviceRef_Dev_0_1 PPB_DeviceRef_Dev;
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_DEV_PPB_DEVICE_REF_DEV_H_ */
+