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 启用 | 已禁用 |
如果驱动程序支持 DRMRIGHTS 并且还实现了专有复制保护机制,则驱动程序必须使用 CopyProtect 和 DigitalOutputDisable 的值聚合专有实现的结果,以确定最终的复制保护状态。 最终的复制保护状态必须是所有未完成的复制保护请求中最严格的。
DEFINE_DRMRIGHTS_DEFAULT宏定义常量 DRMRIGHTS 结构,该结构指定默认 DRM 内容权限。
VOID DEFINE_DRMRIGHTS_DEFAULT(
DRMRIGHTS DrmRights
);
参数
DrmRights
DRMRIGHTS
指定常量 DRMRIGHTS 结构的名称。 宏将 DrmRights 的成员设置为以下默认值:
返回值
VOID
此宏不返回值。
要求
要求 | 值 |
---|---|
Header | drmk.h (包括 Drmk.h) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈