IDrmAudioStream：：SetContentId 方法（drmk.h）

项目
02/06/2025

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 内容权限仍保留在流中设置。

有关使用此方法的详细信息，请参阅 Digital Rights Management。