DrmGetContentRights - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// drmk.h
NTSTATUS DrmGetContentRights(
[in] ULONG ContentId,
[out] PDRMRIGHTS DrmRights
);
View the official Windows Driver Kit DDI referenceNo description available.
The DrmGetContentRights function retrieves the DRM content rights assigned to a DRM content ID.
ContentId [in]Specifies the DRM content ID. This parameter identifies a KS audio stream.
DrmRights [out]Specifies the DRM content rights that are assigned to the stream that is identified by ContentId. This parameter is a pointer to a DRMRIGHTS structure.
DrmGetContentRights returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.
Before a KS audio filter begins mixing together several KS audio streams, it first calls DrmCreateContentMixed to create a content ID for the composite stream. Next, it calls DrmGetContentRights to get the content rights that the system has assigned to the stream.
A module that lies downstream from the KS filter that creates the content ID typically does not need to call DrmGetContentRights. Instead, the module receives both the content ID and content rights either from the system (through an IDrmAudioStream::SetContentId call or a KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property request) or directly from the preceding module in the data path (through a call to a content handler). For more information, see DrmForwardContentToInterface, DrmForwardContentToDeviceObject, and DrmAddContentHandlers.
DrmGetContentRights performs the same function as PcGetContentRights and IDrmPort::GetContentRights. For more information, see DRM Functions and Interfaces.
DrmForwardContentToDeviceObject
KSPROPERTY_DRMAUDIOSTREAM_CONTENTID