MediaProtectionManager class

Contains a content protection manager object, for an application that handles protected media content.

Syntax

var mediaProtectionManager = new Windows.Media.Protection.MediaProtectionManager();

Attributes

ActivatableAttribute(NTDDI_WIN8)

MarshalingBehaviorAttribute(Agile)

ThreadingAttribute(MTA)

VersionAttribute(NTDDI_WIN8)

Members

The MediaProtectionManager class has these types of members:

• Constructors
• Events
• Methods
• Properties

Constructors

The MediaProtectionManager class has these constructors.

Events

The MediaProtectionManager class has these events.

Methods

The MediaProtectionManager class inherits methods from the Object class (C#/VB/C++).

Properties

The MediaProtectionManager class has these properties.

Remarks

The MediaProtectionManager can be passed to the media playback infrastructure in either of two ways:

• As an attribute for a <video> or <audio> tag using the msSetMediaProtectionManager method.
• Directly to a media playback API.

or . The MediaProtectionManager object is notified of content enabler objects. These objects must be processed by the application, to establish access to protected content. Each MediaProtectionManager object is associated with a single instance of playback.

Examples

The following example shows how to create a MediaProtectionManager, set the Properties property, and add event listeners for ComponentLoadFailed and ServiceRequested. See the How to use pluggable DRM topic for the full example.

mediaProtectionManager = 
    new Windows.Media.Protection.MediaProtectionManager();

function ServiceRequested(e) {
   logMsg("Got Enabler - system/type: {" + e.request.protectionSystem + "}/{" + e.request.type + "}");
   e.completion.complete(true);
}


function ComponentLoadFailed(e) {
   logMsg(e.information.items.size.toString() + " failed components");
   logMsg("<h2>Components:</h2>");

   //  List the failing components
   for (var i = 0; i < e.information.items.size; i++) {
      logMsg("<h3>" + e.information.items[i].name + "</h3>" +
             "<p>Reasons=0x" + e.information.items[i].reasons.toString(16) +
             "<p>Renewal Id=" + e.information.items[i].renewalId);
   }

   e.completion.complete(false);
}

function RebootNeeded(e) {
   logMsg("Reboot Required");
}

mediaProtectionManager.addEventListener("servicerequested", ServiceRequested, false);
mediaProtectionManager.addEventListener("componentloadfailed", ComponentLoadFailed, false);
mediaProtectionManager.addEventListener("rebootneeded", RebootNeeded, false);
 

Requirements

Build date: 12/4/2012