/* Copyright 2013 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 API for output protection. Currently, it only supports * Chrome OS. */ [generate_thunk] label Chrome { M31 = 0.1 }; /** * Content protection methods applied on video output link. */ [assert_size(4)] enum PP_OutputProtectionMethod_Private { PP_OUTPUT_PROTECTION_METHOD_PRIVATE_NONE = 0, PP_OUTPUT_PROTECTION_METHOD_PRIVATE_HDCP = 1 << 0 }; /** * Video output link types. */ [assert_size(4)] enum PP_OutputProtectionLinkType_Private { PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_NONE = 0, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_UNKNOWN = 1 << 0, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_INTERNAL = 1 << 1, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_VGA = 1 << 2, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_HDMI = 1 << 3, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_DVI = 1 << 4, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_DISPLAYPORT = 1 << 5, PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_NETWORK = 1 << 6 }; /** * The PPB_OutputProtection_Private interface allows controlling * output protection. * * Example: * * @code * op = output_protection->Create(instance); * output_protection->QueryStatus(op, &link_mask, &protection_mask, * done_callback); * @endcode * * In this example, the plugin wants to enforce HDCP for HDMI link. * @code * if (link_mask & PP_OUTPUT_PROTECTION_LINK_TYPE_PRIVATE_HDMI) { * output_protection->EnableProtection( * op, PP_OUTPUT_PROTECTION_METHOD_PRIVATE_HDCP, done_callback); * } * @endcode * * After EnableProtection() completes, the plugin has to query protection * status periodically to make sure the protection is enabled and remains * enabled. */ interface PPB_OutputProtection_Private { /** * Create() creates a new PPB_OutputProtection_Private object. * * @pram[in] instance A PP_Instance identifying one instance of * a module. * * @return A PP_Resource corresponding to a * PPB_OutputProtection_Private if successful, 0 if creation * failed. */ PP_Resource Create([in] PP_Instance instance); /** * IsOutputProtection() determines if the provided resource is a * PPB_OutputProtection_Private. * * @param[in] resource A PP_Resource corresponding to a * PPB_OutputProtection_Private. * * @return PP_TRUE if the resource is a * PPB_OutputProtection_Private, PP_FALSE if the * resource is invalid or some type other than * PPB_OutputProtection_Private. */ PP_Bool IsOutputProtection([in] PP_Resource resource); /** * Query link status and protection status. * Clients have to query status periodically in order to detect changes. * * @param[in] resource A PP_Resource corresponding to a * PPB_OutputProtection_Private. * @param[out] link_mask The type of connected output links, which is a * bit-mask of the PP_OutputProtectionLinkType_Private values. * @param[out] protection_mask Enabled protection methods, which is a * bit-mask of the PP_OutputProtectionMethod_Private values. * @param[in] callback A PP_CompletionCallback to run on * asynchronous completion of QueryStatus(). This callback will only run if * QueryStatus() returns PP_OK_COMPLETIONPENDING. * * @return An int32_t containing an error code from pp_errors.h. */ int32_t QueryStatus( [in] PP_Resource resource, [out] uint32_t link_mask, [out] uint32_t protection_mask, [in] PP_CompletionCallback callback); /** * Set desired protection methods. * * When the desired protection method(s) have been applied to all applicable * output links, the relevant bit(s) of the protection_mask returned by * QueryStatus() will be set. Otherwise, the relevant bit(s) of * protection_mask will not be set; there is no separate error code or * callback. * * Protections will be disabled if no longer desired by all instances. * * @param[in] resource A PP_Resource corresponding to a * PPB_OutputProtection_Private. * @param[in] desired_protection_mask The desired protection methods, which * is a bit-mask of the PP_OutputProtectionMethod_Private * values. * @param[in] callback A PP_CompletionCallback to be called with * PP_OK when the protection request has been made. This may be * before the protection have actually been applied. Call QueryStatus to get * protection status. If it failed to make the protection request, the * callback is called with PP_ERROR_FAILED and there is no need * to call QueryStatus(). * * @return An int32_t containing an error code from pp_errors.h. */ int32_t EnableProtection( [in] PP_Resource resource, [in] uint32_t desired_protection_mask, [in] PP_CompletionCallback callback); };