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

See also

DRMRIGHTS

DrmAddContentHandlers

DrmCreateContentMixed

DrmForwardContentToDeviceObject

DrmForwardContentToInterface

IDrmAudioStream::SetContentId

IDrmPort::GetContentRights

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcGetContentRights