IMFInputTrustAuthority::GetDecrypter-Methode (mfidl.h)

  • Artikel

Ruft eine Entschlüsselungstransformation ab.

Syntax

HRESULT GetDecrypter(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] riid

Schnittstellenbezeichner (IID) der angeforderten Schnittstelle. Derzeit muss dieser Wert IID_IMFTransform sein, der die IMFTransform-Schnittstelle anfordert.

[out] ppv

Empfängt einen Zeiger auf die Schnittstelle. Der Aufrufer muss die Schnittstelle freigeben.

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.
E_NOINTERFACE
 Der Entschlüsseler unterstützt die angeforderte Schnittstelle nicht.
MF_E_NOT_PROTECTED
 Diese Eingabevertrauensberechtigung (Input Trust Authority, ITA) stellt keinen Entschlüsselungser bereit.

Hinweise

Der Entschlüsseler sollte in einem deaktivierten Zustand erstellt werden, in dem alle Aufrufe von IMFTransform::P rocessOutput automatisch fehlschlagen. Nachdem die Eingabevertrauensberechtigung (Input Trust Authority, ITA) überprüft hat, ob sie innerhalb des geschützten Medienpfads (PMP) ausgeführt wird, sollte das ITA den Entschlüsselungser aktivieren.

Ein ITA ist nicht erforderlich, um einen Entschlüsseler bereitzustellen. Wenn der Quellinhalt nicht verschlüsselt ist, sollte die Methode MF_E_NOT_PROTECTED zurückgeben. Der PMP fährt dann fort, ohne einen Entschlüsseler für diesen Stream zu verwenden.

Der ITA muss für jeden Aufruf von GetDecrypter eine neue instance seines Entschlüsselers erstellen. Geben Sie nicht mehrere Verweise auf denselben Entschlüsseler zurück. Sie müssen separate Instanzen sein, da die Mediensitzung sie möglicherweise in zwei verschiedenen Verzweigungen der Topologie platziert.

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
Bibliothek Mfuuid.lib

Weitere Informationen

IMFInputTrustAuthority