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

  • Статья

Функция устарела DrmForwardContentToFileObject и поддерживается только для поддержки существующих драйверов. Эта функция отправляет операционной системе файловый объект, представляющий устройство, которое обрабатывает защищенное содержимое. Он также пересылает указанному устройству идентификатор содержимого и связанные права DRM потока, содержащего защищенное содержимое.

Синтаксис

NTSTATUS DrmForwardContentToFileObject(
  [in] ULONG        ContentId,
  [in] PFILE_OBJECT FileObject
);

Параметры

[in] ContentId

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

[in] FileObject

Указатель на файловый объект, представляющий аудио пин-код KS, в который отправляется аудиопоток KS.

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

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

Код возврата Описание
STATUS_NOT_IMPLEMENTED
 Указывает, что аудио пин-код KS, связанный с FileObject , не поддерживает права содержимого DRM, назначенные ContentId.

Комментарии

Эта функция заменена drmForwardContentToDeviceObject. Драйвер, который вызывает DrmForwardContentToFileObject , заставляет систему работать на более низком уровне безопасности DRM. Вместо этого следует вызывать DrmForwardContentToDeviceObject новые драйверы.

Функция DrmForwardContentToFileObject проверяет подлинность звукового фильтра KS, который реализует аудио пин-код KS, представленный FileObject. При DrmForwardContentToFileObject успешной проверке подлинности звукового фильтра KS он задает свойство KS KSPROPERTY_DRMAUDIOSTREAM_CONTENTID на звуковом контакте, представленном FileObject. Данные свойства включают идентификатор содержимого DRM и структуру DRMRIGHTS . DrmForwardContentToFileObject не использует FileObject после возврата.

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

Требования

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

См. также раздел

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject