Функция DrmGetContentRights (drmk.h)

Статья
02/06/2025

Функция DrmGetContentRights извлекает права на содержимое DRM, назначенные идентификатору содержимого DRM.

Синтаксис

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

Параметры

[in] ContentId

Указывает идентификатор содержимого DRM. Этот параметр определяет аудиопоток KS.

[out] DrmRights

Указывает права на содержимое DRM, назначенные потоку, который определяется ContentId. Этот параметр является указателем на структуру DRMRIGHTS.

Возвращаемое значение

DrmGetContentRights возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки.

Замечания

Перед началом объединения нескольких аудиопотоков KS он сначала вызывает DrmCreateContentMixed для создания идентификатора содержимого для составного потока. Затем он вызывает DrmGetContentRights, чтобы получить права на содержимое, назначенные системе потоку.

Модуль, который находится внизу из фильтра KS, который создает идентификатор содержимого, обычно не требует вызова DrmGetContentRights. Вместо этого модуль получает как идентификатор содержимого, так и права содержимого из системы (через IDrmAudioStream::SetContentId вызов или запрос KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property) или непосредственно из предыдущего модуля в пути к данным (через вызов обработчика содержимого). Дополнительные сведения см. в разделе DrmForwardContentToInterface, DrmForwardContentToDeviceObjectи DrmAddContentHandlers.

DrmGetContentRights выполняет ту же функцию, что и PcGetContentRights и IDrmPort::GetContentRights. Дополнительные сведения см. в функций и интерфейсов DRM.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	drmk.h (include Drmk.h)
библиотеки	Drmk.lib
IRQL	PASSIVE_LEVEL