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 |
|---|---|
|
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
DrmForwardContentToDeviceObject
IDrmPort::ForwardContentToFileObject