Interface IMFContentProtectionManager (mfidl.h)

  • Article

Active la lecture du contenu protégé en fournissant à l’application un pointeur vers un objet d’activation de contenu.

Les applications qui luent du contenu protégé doivent implémenter cette interface.

Héritage

L’interface IMFContentProtectionManager hérite de l’interface IUnknown. IMFContentProtectionManager a également les types de membres suivants :

Méthodes

L’interface IMFContentProtectionManager a ces méthodes.

 
IMFContentProtectionManager ::BeginEnableContent

Commence une demande asynchrone pour effectuer une action d’activation de contenu.
IMFContentProtectionManager ::EndEnableContent

Met fin à une demande asynchrone pour effectuer une action d’activation de contenu. Cette méthode est appelée par le chemin d’accès multimédia protégé (PMP) pour effectuer un appel asynchrone à IMFContentProtectionManager ::BeginEnableContent.

Remarques

Un enabler de contenu est un objet qui effectue une action nécessaire pour lire un élément de contenu protégé. Par exemple, l’action peut être l’obtention d’une licence DRM. Les enablers de contenu exposent l’interface IMFContentEnabler , qui définit un mécanisme générique pour l’activation de contenu. Les enablers de contenu sont créés à l’intérieur du processus PMP (Protected Media Path). Toutefois, elles doivent être appelées à partir du processus d’application. Par conséquent, l’interface IMFContentProtectionManager permet à la session multimédia PMP de notifier l’application.

Pour utiliser cette interface, procédez comme suit :

  1. Implémentez l’interface dans votre application.
  2. Créez un magasin d’attributs en appelant MFCreateAttributes.
  3. Définissez l’attribut MF_SESSION_CONTENT_PROTECTION_MANAGER sur le magasin d’attributs. La valeur de l’attribut est un pointeur vers votre implémentation IMFContentProtectionManager .
  4. Appelez MFCreatePMPMediaSession et passez le magasin d’attributs dans le paramètre pConfiguration .
Si le contenu nécessite un enabler de contenu, la méthode BeginEnableContent de l’application est appelée. Généralement, cette méthode est appelée pendant l’opération IMFMediaSession ::SetTopology , avant que media session déclenche l’événement MESessionTopologySet . L’application peut recevoir plusieurs appels BeginEnableContent pour un seul élément de contenu. L’événement MESessionTopologySet indique que le processus d’activation du contenu est terminé pour la topologie actuelle. La méthode BeginEnableContent peut également être appelée en dehors de l’opération SetTopology , mais moins souvent.

De nombreux enablers de contenu envoient des données spécifiques à l’ordinateur au réseau, ce qui peut avoir des implications sur la confidentialité. L’un des objectifs de l’interface IMFContentProtectionManager est de donner aux applications la possibilité d’afficher des informations à l’utilisateur et de permettre aux utilisateurs d’accepter ou de refuser le processus.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfidl.h

Voir aussi

Interfaces Media Foundation