DrmForwardContentToFileObject 函数（drmk.h）

项目
02/06/2025

DrmForwardContentToFileObject 函数已过时，仅维护为支持现有驱动程序。此函数向作系统发送一个表示处理受保护内容的设备的文件对象。它还将内容 ID 和包含受保护内容的流的关联 DRM 权限转发到指定的设备。

语法

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

参数

[in] ContentId

指定 DRM 内容 ID。此参数标识受保护的 KS 音频流。

[in] FileObject

指向表示 KS 音频流发送到的 KS 音频引脚的文件对象的指针。

返回值

如果调用成功，DrmForwardContentToFileObject 返回STATUS_SUCCESS。下表显示了一些可能的错误返回值。

返回代码	描述
STATUS_NOT_IMPLEMENTED	指示与 fileObject 关联的 KS 音频引脚不支持分配给 ContentId的 DRM 内容权限。

言论

此函数由 DrmForwardContentToDeviceObject取代。调用 DrmForwardContentToFileObject 的驱动程序强制系统在较低的 DRM 安全级别运行。新驱动程序应改为调用 DrmForwardContentToDeviceObject。

DrmForwardContentToFileObject 函数对实现由 FileObject表示的 KS 音频引脚的 KS 音频筛选器进行身份验证。如果 DrmForwardContentToFileObject 成功对 KS 音频筛选器进行身份验证，则会在 由 fileObject表示的音频引脚上设置 KS 属性 KSPROPERTY_DRMAUDIOSTREAM_CONTENTID。属性数据包括 DRM 内容 ID 和 DRMRIGHTS 结构。 DrmForwardContentToFileObject 在返回后不使用 FileObject。

DrmForwardContentToFileObject 执行与 PcForwardContentToFileObject 和 IDrmPort：：ForwardContentToFileObject相同的函数。有关详细信息，请参阅 DRM 函数和接口。