Метод IDrmAudioStream::SetContentId (drmk.h)

Статья
02/26/2024

Метод SetContentId задает идентификатор содержимого DRM и назначенные ему права на содержимое DRM в аудиопотоке KS.

Синтаксис

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

Параметры

[in] ContentId

Указывает идентификатор содержимого DRM. Этот параметр является идентификатором, который система DRM создает во время выполнения для идентификации содержимого, защищенного DRM, в этом потоке.

[in] DrmRights

Указатель на структуру DRMRIGHTS , указывающую права, предоставленные поставщиком содержимого пользователю для воспроизведения и копирования содержимого, защищенного DRM, в этом потоке.

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

SetContentId возвращает STATUS_SUCCESS, если вызов был выполнен успешно. В противном случае метод возвращает соответствующий код ошибки. Если фильтр не может применить указанные права на содержимое, метод возвращает STATUS_NOT_IMPLEMENTED.

Звуковой фильтр KS завершает выполнение вызова SetContentId метода синхронно. Если функция возвращает STATUS_SUCCESS, это означает, что все подчиненные звуковые узлы KS (см. раздел Узлы топологии звука) аудиопотока KS также успешно настроены с указанным идентификатором содержимого DRM и правами на содержимое DRM. (Термин подчиненный узел означает прямой или непрямой приемник для аудиопотока.)

Если звуковой фильтр KS не может применить указанные права на содержимое DRM, SetContentId метод возвращает код ошибки STATUS_NOT_IMPLEMENTED. В этом случае ранее заданный идентификатор содержимого DRM аудиопотока KS и права на содержимое DRM остаются заданными в потоке.

Дополнительные сведения об использовании этого метода см. в разделе Digital Rights Management.