DrmForwardContentToFileObject-Funktion (drmk.h)

Die DrmForwardContentToFileObject Funktion ist veraltet und wird nur für die Unterstützung vorhandener Treiber beibehalten. Diese Funktion sendet das Betriebssystem ein Dateiobjekt, das ein Gerät darstellt, das geschützte Inhalte behandelt. Sie leitet auch an das angegebene Gerät die Inhalts-ID und zugeordnete DRM-Rechte eines Datenstroms mit geschützten Inhalten weiter.

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-Audiostrom.

[in] FileObject

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

Rückgabewert

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

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

Bemerkungen

Diese Funktion wird von DrmForwardContentToDeviceObject ersetzt. Ein Treiber, der das System aufruft DrmForwardContentToFileObject , auf einer niedrigeren DRM-Sicherheitsstufe auszuführen. Stattdessen sollten neue Treiber aufgerufen DrmForwardContentToDeviceObject werden.

Die DrmForwardContentToFileObject Funktion authentifiziert den KS-Audiofilter, der die KS-Audiohefte implementiert, die durch FileObject dargestellt wird. Wenn DrmForwardContentToFileObject der KS-Audiofilter erfolgreich authentifiziert wird, wird die KS-Eigenschaft KSPROPERTY_DRMAUDIOSTREAM_CONTENTID auf der Audio-Pin festgelegt, die durch FileObject dargestellt wird. Die Eigenschaftendaten umfassen eine DRM-Inhalts-ID und eine DRMRIGHTS-Struktur . DrmForwardContentToFileObject verwendet fileObject nach der Rückgabe keine Verwendung von FileObject .

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

Anforderungen

   
Zielplattform Universell
Header drmk.h (einschließlich Drmk.h)
Bibliothek Drmk.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject