DrmGetContentRights function

The DrmGetContentRights function retrieves the DRM content rights assigned to a DRM content ID.

Syntax


NTSTATUS DrmGetContentRights(
  _In_   ULONG ContentId,
  _Out_  PDRMRIGHTS DrmRights
);

Parameters

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.

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

Header

Drmk.h (include Drmk.h)

Library

Drmk.lib

IRQL

PASSIVE_LEVEL

See also

DRMRIGHTS
DrmCreateContentMixed
IDrmAudioStream::SetContentId
KSPROPERTY_DRMAUDIOSTREAM_CONTENTID
DrmForwardContentToInterface
DrmForwardContentToDeviceObject
DrmAddContentHandlers
PcGetContentRights
IDrmPort::GetContentRights

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft