DrmForwardContentToFileObject 函数 (drmk.h)

项目
08/07/2023

函数 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 函数和接口。