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 |
|---|---|
|
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
DrmForwardContentToDeviceObject
IDrmPort::ForwardContentToFileObject