iDrmAudioStream：：SetContentId 方法 (drmk.h)

项目
08/07/2023

方法 SetContentId 设置 DRM 内容 ID 及其在 KS 音频流上分配的 DRM 内容权限。

语法

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

参数

[in] ContentId

指定 DRM 内容 ID。此参数是 DRM 系统在运行时生成的标识符，用于标识此流中受 DRM 保护的内容。

[in] DrmRights

指向 DRMRIGHTS 结构的指针，该结构指定内容提供商授予用户用于在此流中播放和复制受 DRM 保护的内容的权限。

返回值

SetContentId 如果调用成功，则返回STATUS_SUCCESS。否则，该方法将返回相应的错误代码。如果筛选器无法强制实施指定的内容权限，该方法将返回STATUS_NOT_IMPLEMENTED。

注解

DRM 系统可以在 KS 音频流的生存期内随时调用 SetContentId 方法。

KS 音频筛选器同步完成对 SetContentId 方法的调用的执行。如果函数返回STATUS_SUCCESS，则表示所有下游 KS 音频节点 (看到音频拓扑节点) KS 音频流也已成功配置指定的 DRM 内容 ID 和 DRM 内容权限。 (术语 下游节点 是指音频流的直接或间接接收器。)

如果 KS 音频筛选器无法强制实施指定的 DRM 内容权限，该方法 SetContentId 将返回错误代码STATUS_NOT_IMPLEMENTED。在这种情况下，KS 音频流的以前设置的 DRM 内容 ID 和 DRM 内容权限将保留在流上。

有关使用此方法的详细信息，请参阅数字版权管理。