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

Статья
02/06/2025

Функция 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 (include Drmk.h)
библиотеки	Drmk.lib
IRQL	PASSIVE_LEVEL

См. также

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject

Поделиться через