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。 相反,模块接收来自系统的内容 ID 和内容权限(通过 IDrmAudioStream::SetContentId 调用或 KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property 请求),或者直接从数据路径中前面的模块(通过对内容处理程序的调用)。 有关详细信息,请参阅 DrmForwardContentToInterfaceDrmForwardContentToDeviceObject,以及 DrmAddContentHandlers

DrmGetContentRights 执行与 PcGetContentRightsIDrmPort::GetContentRights相同的功能。 有关详细信息,请参阅 DRM 函数和接口

要求

要求 价值
目标平台 普遍
标头 drmk.h (包括 Drmk.h)
Drmk.lib
IRQL PASSIVE_LEVEL

另请参阅

DRMRIGHTS

DrmAddContentHandlers

DrmCreateContentMixed

DrmForwardContentToDeviceObject

DrmForwardContentToInterface

IDrmAudioStream::SetContentId

IDrmPort::GetContentRights

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcGetContentRights