drmk.h) (DRMRIGHTS 结构

  • 项目

DRMRIGHTS 结构指定分配给 KS 音频引脚或端口类驱动程序的流对象的 DRM 内容权限。

语法

typedef struct tagDRMRIGHTS {
  BOOL  CopyProtect;
  ULONG Reserved;
  BOOL  DigitalOutputDisable;
} DRMRIGHTS, *PDRMRIGHTS;

成员

CopyProtect

指定以下复制保护值之一：

TRUE

启用复制保护。 音频应用程序不得执行以下操作：

  • 以任何形式将内容存储在任何非易失性存储中。
  • 按引用或值将内容传递给主机系统中未经 DRM 系统身份验证的任何其他组件。

FALSE

禁用复制保护。 可以不受限制地复制内容。

有关 CopyProtect 的详细信息，请参阅“备注”部分。

Reserved

保留供将来使用。 初始化为零。

DigitalOutputDisable

指定以下数字输出保护值之一：

TRUE

禁用数字输出。 软件组件不得通过任何类型的数字接口将内容从主机系统传出。 请注意，数字输出保护不会影响 USB 设备，因为主机系统包含 USB 设备。

FALSE

启用数字输出。 内容可以不受限制地从主机系统传输到外部组件。

有关 DigitalOutputDisable 的详细信息，请参阅“备注”部分。

注解

Windows 认证计划对音频驱动程序处理 CopyProtect 和 DigitalOutputDisable 值的方式提出了特定要求。 当 CopyProtect 和 DigitalOutputDisable 值应用于音频流以及从中访问音频流的输出时，这些要求适用。 Windows 7 的新要求包括为 S/PDIF 终结点 (SCMS) 对串行复制管理系统进行编程的正确方法，以及 HDMI 终结点的高带宽数字内容保护 (HDCP) 。

下表总结了驱动程序必须为 CopyProtect 和 DigitalOutputDisable 的不同值建立的内容保护状态。

DRMRIGHTS 布尔成员 生成的内容保护
DigitalOutputDisable CopyProtect HDMI 和显示端口 S/PDIF
False False 已启用，但没有 HDCP 已启用，但没有 SCMS
False True 使用 HDCP 启用 使用 SCMS 启用
True 不在乎 使用 HDCP 启用 已禁用
 
注意 如果驱动程序无法正确应用 HDCP 或 SCMS，则驱动程序必须禁用到终结点的输出。
 
当音频驱动程序将 SCMS 复制保护应用于 S/PDIF 终结点时，音频驱动程序使用 L、Cp 和类别代码位的组合来选择 SCMS 状态“从不复制”。 有关数字内容复制保护的详细信息，请参阅 IEC 网站上的 IEC 60958 。

如果驱动程序支持 DRMRIGHTS 并且还实现了专有复制保护机制，则驱动程序必须使用 CopyProtect 和 DigitalOutputDisable 的值聚合专有实现的结果，以确定最终的复制保护状态。 最终的复制保护状态必须是所有未完成的复制保护请求中最严格的。

DEFINE_DRMRIGHTS_DEFAULT宏定义常量 DRMRIGHTS 结构，该结构指定默认 DRM 内容权限。

VOID DEFINE_DRMRIGHTS_DEFAULT(
   DRMRIGHTS DrmRights
);

参数

DrmRights

DRMRIGHTS

指定常量 DRMRIGHTS 结构的名称。 宏将 DrmRights 的成员设置为以下默认值：

返回值

VOID

此宏不返回值。

要求

要求 值
Header drmk.h (包括 Drmk.h)

另请参阅

DrmCreateContentMixed

DrmDestroyContent

DrmForwardContentToFileObject

DrmForwardContentToInterface

DrmGetContentRights

IEC 60958