IMFContentProtectionManager::BeginEnableContent-Methode (mfidl.h)

  • Artikel

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

Diese Methode fordert die Anwendung auf, mithilfe eines Content Enabler-Objekts einen bestimmten Schritt auszuführen, der zum Abrufen von Rechten für den Inhalt erforderlich ist.

Syntax

HRESULT BeginEnableContent(
  [in] IMFActivate      *pEnablerActivate,
  [in] IMFTopology      *pTopo,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameter

[in] pEnablerActivate

Zeiger auf die IMFActivate-Schnittstelle eines Content Enabler-Objekts. Um den Content Enabler zu erstellen, rufen Sie IMFActivate::ActivateObject auf, und fordern Sie die IMFContentEnabler-Schnittstelle an. Die Anwendung sollte die Methoden in IMFContentEnabler verwenden, um die Content-Aktivierungsaktion abzuschließen.

[in] pTopo

Zeiger auf die IMFTopology-Schnittstelle der ausstehenden Topologie.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Wenn der Vorgang abgeschlossen ist, sollte die Anwendung IMFAsyncCallback::Invoke für den Rückruf aufrufen.

[in] punkState

Reserviert. Derzeit ist dieser Parameter immer NULL.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Methode wurde erfolgreich ausgeführt.

Hinweise

Blockieren Sie nicht innerhalb dieser Rückrufmethode. Führen Sie stattdessen die Inhaltsaktivierungsaktion asynchron in einem anderen Thread aus. Wenn der Vorgang abgeschlossen ist, benachrichtigen Sie den Geschützten Medienpfad (PMP) über den pCallback-Parameter .

Wenn Sie einen Erfolgscode von dieser Methode zurückgeben, müssen Sie Invoke für den Rückruf aufrufen. Wenn Sie hingegen einen Fehlercode von dieser Methode zurückgeben, dürfen Sie Invoke nicht aufrufen. Wenn der Vorgang fehlschlägt, nachdem die Methode einen Erfolgscode zurückgegeben hat, verwenden Sie status Code für das IMFAsyncResult-Objekt, um den Fehler zu melden.

Nachdem der Rückruf aufgerufen wurde, ruft der PMP die IMFContentProtectionManager::EndEnableContent-Methode der Anwendung auf, um den asynchronen Aufruf abzuschließen.

Diese Methode wird nicht unbedingt jedes Mal aufgerufen, wenn die Anwendung geschützte Inhalte wiedergibt. Im Allgemeinen wird die Methode nicht aufgerufen, wenn der Benutzer über eine gültige, aktuelle Lizenz für den Inhalt verfügt. Intern bestimmt die Eingabevertrauensberechtigung (Input Trust Authority, ITA), ob BeginEnableContent aufgerufen wird, basierend auf der DRM-Richtlinie des Inhaltsanbieters. Weitere Informationen finden Sie unter Pfad für geschützte Medien.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFActivate

IMFContentProtectionManager