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.
NTSTATUS DrmForwardContentToFileObject( _In_ ULONG ContentId, _In_ PFILE_OBJECT FileObject );
Specifies the DRM content ID. This parameter identifies a protected KS audio stream.
Pointer to a file object that represents the KS audio pin to which the KS audio stream is sent.
DrmForwardContentToFileObject returns STATUS_SUCCESS if the call was successful. The following table shows some of the possible error return values.
||Indicates that the KS audio pin that is associated with FileObject does not support the DRM content rights that are assigned to ContentId.|
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
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.
|Header||drmk.h (include Drmk.h)|