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

Статья
03/05/2024

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

Синтаксис

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

Параметры

[in] ContentId

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

[out] DrmRights

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

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

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

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

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

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

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	drmk.h (включая Drmk.h)
Библиотека	Drmk.lib
IRQL	PASSIVE_LEVEL