IMFContentProtectionManager-Schnittstelle (mfidl.h)

  • Artikel

Ermöglicht die Wiedergabe von geschützten Inhalten, indem der Anwendung ein Zeiger auf ein Content Enabler-Objekt bereitgestellt wird.

Anwendungen, die geschützte Inhalte wiedergeben, sollten diese Schnittstelle implementieren.

Vererbung

Die IMFContentProtectionManager-Schnittstelle erbt von der IUnknown-Schnittstelle . IMFContentProtectionManager verfügt auch über folgende Membertypen:

Methoden

Die IMFContentProtectionManager-Schnittstelle verfügt über diese Methoden.

 
IMFContentProtectionManager::BeginEnableContent

Startet eine asynchrone Anforderung zum Ausführen einer Aktion zum Aktivieren von Inhalten.
IMFContentProtectionManager::EndEnableContent

Beendet eine asynchrone Anforderung zum Ausführen einer Aktion zum Aktivieren von Inhalten. Diese Methode wird vom Geschützten Medienpfad (PMP) aufgerufen, um einen asynchronen Aufruf von IMFContentProtectionManager::BeginEnableContent abzuschließen.

Hinweise

Ein Inhaltsaktivierer ist ein Objekt, das eine Aktion ausführt, die zum Wiedergeben eines teils geschützten Inhalts erforderlich ist. Die Aktion kann beispielsweise eine DRM-Lizenz erhalten. Inhaltsaktivatoren machen die IMFContentEnabler-Schnittstelle verfügbar, die einen generischen Mechanismus für die Inhaltsaktivierer definiert. Inhaltsaktivatoren werden innerhalb des PMP-Prozesses (Protected Media Path) erstellt. Sie müssen jedoch aus dem Bewerbungsprozess aufgerufen werden. Daher bietet die IMFContentProtectionManager-Schnittstelle eine Möglichkeit für die PMP-Mediensitzung, die Anwendung zu benachrichtigen.

Gehen Sie wie folgt vor, um diese Schnittstelle zu verwenden:

  1. Implementieren Sie die Schnittstelle in Ihrer Anwendung.
  2. Erstellen Sie einen Attributspeicher, indem Sie MFCreateAttributes aufrufen.
  3. Legen Sie das attribut MF_SESSION_CONTENT_PROTECTION_MANAGER im Attributspeicher fest. Der Attributwert ist ein Zeiger auf Ihre IMFContentProtectionManager-Implementierung .
  4. Rufen Sie MFCreatePMPMediaSession auf, und übergeben Sie den Attributspeicher im pConfiguration-Parameter .
Wenn der Inhalt einen Inhaltsaktivierer erfordert, wird die BeginEnableContent-Methode der Anwendung aufgerufen. Normalerweise wird diese Methode während des IMFMediaSession::SetTopology-Vorgangs aufgerufen, bevor die Mediensitzung das MESessionTopologySet-Ereignis auslöst. Die Anwendung erhält möglicherweise mehrere BeginEnableContent-Aufrufe für einen einzelnen Inhalt. Das MESessionTopologySet-Ereignis signalisiert, dass der Inhaltsermöglichungsprozess für die aktuelle Topologie abgeschlossen ist. Die BeginEnableContent-Methode kann auch außerhalb des SetTopology-Vorgangs aufgerufen werden, jedoch weniger häufig.

Viele Inhaltsaktivierer senden computerspezifische Daten an das Netzwerk, was Auswirkungen auf den Datenschutz haben kann. Einer der Zwecke der IMFContentProtectionManager-Schnittstelle besteht darin, Anwendungen die Möglichkeit zu geben, dem Benutzer Informationen anzuzeigen und Benutzern das Opt-in oder-Out des Prozesses zu ermöglichen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h

Weitere Informationen

Media Foundation-Schnittstellen