summaryrefslogtreecommitdiffstats
path: root/ppapi/api/trusted/ppb_audio_trusted.idl
blob: 6cd27f60420079f96fc7604e9b56e7c302780ec2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
/* Copyright (c) 2011 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.
 */

/**
 * This file defines the trusted audio interface.
 */

label Chrome {
  M14 = 0.6
};

/**
 * This interface is to be used by proxy implementations.  All
 * functions should be called from the main thread only.  The
 * resource returned is an Audio resource; most of the PPB_Audio
 * interface is also usable on this resource.
 */
[mainthread, macro="PPB_AUDIO_TRUSTED_INTERFACE"]
interface PPB_AudioTrusted {
  /** Returns an audio resource. */
  PP_Resource CreateTrusted(
      [in] PP_Instance instance);

  /**
   * Opens a paused audio interface, used by trusted side of proxy.
   * Returns PP_ERROR_WOULD_BLOCK on success, and invokes
   * the |create_callback| asynchronously to complete.
   * As this function should always be invoked from the main thread,
   * do not use the blocking variant of PP_CompletionCallback.
   */
  int32_t Open(
      [in] PP_Resource audio,
      [in] PP_Resource config,
      [in] PP_CompletionCallback create_callback);

  /**
   * Get the sync socket.  Use once Open has completed.
   * Returns PP_OK on success.
   */
  int32_t GetSyncSocket(
      [in] PP_Resource audio,
      [out] handle_t sync_socket);

  /**
   * Get the shared memory interface.  Use once Open has completed.
   * Returns PP_OK on success.
   */
  int32_t GetSharedMemory(
      [in] PP_Resource audio,
      [out] handle_t shm_handle,
      [out] uint32_t shm_size);
};