DrmGetContentRights function (drmk.h)
The DrmGetContentRights function retrieves the DRM content rights assigned to a DRM content ID.
Syntax
NTSTATUS DrmGetContentRights(
[in] ULONG ContentId,
[out] PDRMRIGHTS DrmRights
);
Parameters
[in] ContentId
Specifies the DRM content ID. This parameter identifies a KS audio stream.
[out] DrmRights
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.
Return value
DrmGetContentRights returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.
Remarks
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.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | drmk.h (include Drmk.h) |
| Library | Drmk.lib |
| IRQL | PASSIVE_LEVEL |
See also
DrmForwardContentToDeviceObject