Метод IDrmAudioStream::SetContentId (drmk.h)
Метод 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.
Замечания
Система DRM может вызывать метод SetContentId в любое время во время существования аудиопотока KS.
Звуковой фильтр KS завершает выполнение вызова метода SetContentId синхронно. Если функция возвращает STATUS_SUCCESS, это означает, что все подчиненные звуковые узлы KS (см. узлы аудио топологии) аудиопотока KS также были успешно настроены с указанным идентификатором содержимого DRM и правами на содержимое DRM. (Термин нижнего узла относится либо к прямому или косвенному приемнику для аудиопотока.)
Если звуковой фильтр KS не может применить указанные права на содержимое DRM, метод SetContentId возвращает код ошибки STATUS_NOT_IMPLEMENTED. В этом случае ранее заданный идентификатор содержимого DRM и права на содержимое DRM аудиопотока KS остаются в потоке.
Дополнительные сведения об использовании этого метода см. в digital Rights Management.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | drmk.h (include Drmk.h) |
| IRQL | PASSIVE_LEVEL |