DrmForwardContentToFileObject function (drmk.h)

The DrmForwardContentToFileObject function is obsolete and is maintained only to support existing drivers. This function sends the operating system a file object representing a device that handles protected content. It also forwards to the specified device the content ID and associated DRM rights of a stream containing protected content.

Syntax

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

Parameters

[in] ContentId

Specifies the DRM content ID. This parameter identifies a protected KS audio stream.

[in] FileObject

Pointer to a file object that represents the KS audio pin to which the KS audio stream is sent.

Return value

DrmForwardContentToFileObject returns STATUS_SUCCESS if the call was successful. The following table shows some of the possible error return values.

Return code Description
STATUS_NOT_IMPLEMENTED
Indicates that the KS audio pin that is associated with FileObject does not support the DRM content rights that are assigned to ContentId.

Remarks

This function is superseded by DrmForwardContentToDeviceObject. A driver that calls DrmForwardContentToFileObject forces the system to run at a lower DRM security level. New drivers should call DrmForwardContentToDeviceObject instead.

The DrmForwardContentToFileObject function authenticates the KS audio filter that implements the KS audio pin represented by FileObject. If DrmForwardContentToFileObject successfully authenticates the KS audio filter, it sets the KS property KSPROPERTY_DRMAUDIOSTREAM_CONTENTID on the audio pin that is represented by FileObject. The property data includes a DRM content ID and a DRMRIGHTS structure. DrmForwardContentToFileObject makes no use of FileObject after returning.

DrmForwardContentToFileObject performs the same function as PcForwardContentToFileObject and IDrmPort::ForwardContentToFileObject. For more information, see DRM Functions and Interfaces.

Requirements

Requirement Value
Target Platform Universal
Header drmk.h (include Drmk.h)
Library Drmk.lib
IRQL PASSIVE_LEVEL

See also

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject