DrmForwardContentToFileObject-Funktion (drmk.h)

Artikel
02/29/2024

Die DrmForwardContentToFileObject Funktion ist veraltet und wird nur zur Unterstützung vorhandener Treiber beibehalten. Diese Funktion sendet dem Betriebssystem ein Dateiobjekt, das ein Gerät darstellt, das geschützte Inhalte verarbeitet. Außerdem werden die Inhalts-ID und die zugehörigen DRM-Rechte eines Datenstroms, der geschützte Inhalte enthält, an das angegebene Gerät weitergeleitet.

Syntax

NTSTATUS DrmForwardContentToFileObject(
  [in] ULONG        ContentId,
  [in] PFILE_OBJECT FileObject
);

Parameter

[in] ContentId

Gibt die DRM-Inhalts-ID an. Dieser Parameter identifiziert einen geschützten KS-Audiodatenstrom.

[in] FileObject

Zeiger auf ein Dateiobjekt, das den KS-Audio-Pin darstellt, an den der KS-Audiodatenstrom gesendet wird.

Rückgabewert

DrmForwardContentToFileObject gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. In der folgenden Tabelle sind einige der möglichen Fehlerrückgabewerte aufgeführt.

Rückgabecode	Beschreibung
STATUS_NOT_IMPLEMENTED	Gibt an, dass der KS-Audio-Pin, der FileObject zugeordnet ist, die DRM-Inhaltsrechte, die ContentId zugewiesen sind, nicht unterstützt.

Hinweise

Diese Funktion wird durch DrmForwardContentToDeviceObject ersetzt. Ein Treiber, der aufruft DrmForwardContentToFileObject , erzwingt, dass das System auf einer niedrigeren DRM-Sicherheitsstufe ausgeführt wird. Stattdessen sollten neue Treiber aufrufen DrmForwardContentToDeviceObject .

Die DrmForwardContentToFileObject Funktion authentifiziert den KS-Audiofilter, der den KS-Audio-Pin implementiert, der durch FileObject dargestellt wird. Wenn DrmForwardContentToFileObject der KS-Audiofilter erfolgreich authentifiziert wird, wird die KS-Eigenschaft KSPROPERTY_DRMAUDIOSTREAM_CONTENTID für den Audio-Pin festgelegt, der durch FileObject dargestellt wird. Die Eigenschaftendaten enthalten eine DRM-Inhalts-ID und eine DRMRIGHTS-Struktur . DrmForwardContentToFileObject verwendet FileObject nach der Rückgabe nicht.

DrmForwardContentToFileObject führt die gleiche Funktion wie PcForwardContentToFileObject und IDrmPort::ForwardContentToFileObject aus. Weitere Informationen finden Sie unter DRM-Funktionen und -Schnittstellen.