drmGetContentRights 函数 (drmk.h)

函数 DrmGetContentRights 检索分配给 DRM 内容 ID 的 DRM 内容权限。

语法

NTSTATUS DrmGetContentRights(
  [in]  ULONG      ContentId,
  [out] PDRMRIGHTS DrmRights
);

[in] ContentId

指定 DRM 内容 ID。此参数标识 KS 音频流。

[out] DrmRights

指定分配给 ContentId 标识的流的 DRM 内容权限。此参数是指向 DRMRIGHTS 结构的指针。

DrmGetContentRights 如果调用成功，则返回STATUS_SUCCESS。否则，它将返回相应的错误代码。

在 KS 音频筛选器开始混合多个 KS 音频流之前，它首先调用 DrmCreateContentMixed 为复合流创建内容 ID。接下来，它会调用 DrmGetContentRights 以获取系统已分配给流的内容权限。

从 KS 筛选器下游创建内容 ID 的模块通常不需要调用 DrmGetContentRights。相反，模块通过 IDrmAudioStream：：SetContentId 调用或 ) KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property 请求从系统 (接收内容 ID 和内容权限，或者直接从数据路径中的上一模块接收内容 ID 和内容权限， (通过调用内容处理程序) 。有关详细信息，请参阅 DrmForwardContentToInterface、 DrmForwardContentToDeviceObject 和 DrmAddContentHandlers。

DrmGetContentRights 执行与 PcGetContentRights 和 IDrmPort：：GetContentRights 相同的功能。有关详细信息，请参阅 DRM 函数和接口。