IMFContentProtectionManager::BeginEnableContent-Methode (mfidl.h)

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

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

Syntax

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

Die Parameter

[in] pEnablerActivate

Zeiger auf die IMFActivate-Schnittstelle eines Inhaltsaktivierungsobjekts. Rufen Sie ZUM Erstellen der Inhaltsaktivierung IMFActivate::ActivateObject auf , und fordern Sie die IMFContentEnabler-Schnittstelle an. Die Anwendung sollte die Methoden in IMFContentEnabler verwenden, um die Aktion zum Aktivieren von Inhalten abzuschließen.

[in] pTopo

Zeiger auf die IMFTopology-Schnittstelle der ausstehenden Topologie.

[in] pCallback

Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Nach Abschluss des Vorgangs 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Bemerkungen

Blockieren Sie nicht innerhalb dieser Rückrufmethode. Führen Sie stattdessen die Aktion zum Aktivieren von Inhalten 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 aus dieser Methode zurückgeben, müssen Sie "Invoke " für den Rückruf aufrufen. Wenn Sie dagegen einen Fehlercode aus 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 den Statuscode 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 wiederzugeben. Im Allgemeinen wird die Methode nicht aufgerufen, wenn der Benutzer über eine gültige, up-to-date-Lizenz für den Inhalt verfügt. Intern bestimmt die Eingabevertrauensstellen (INPUT Trust Authority, ITA), ob BeginEnableContent aufgerufen wird, basierend auf der DRM-Richtlinie des Inhaltsanbieters. Weitere Informationen finden Sie unter "Geschützter Medienpfad".

Anforderungen

Siehe auch

IMFActivate-

IMFContentProtectionManager