Skip to content

Latest commit

 

History

History
109 lines (66 loc) · 4.45 KB

nf-drmk-drmgetcontentrights.md

File metadata and controls

109 lines (66 loc) · 4.45 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:drmk.DrmGetContentRights
DrmGetContentRights function (drmk.h)
The DrmGetContentRights function retrieves the DRM content rights assigned to a DRM content ID.
audio\drmgetcontentrights.htm
audio
05/08/2018
DrmGetContentRights function
DrmGetContentRights, DrmGetContentRights function [Audio Devices], aud-prop2_9f836831-bb65-45d1-8701-4aaa77999b81.xml, audio.drmgetcontentrights, drmk/DrmGetContentRights
drmk.h
Drmk.h
Universal
Drmk.lib
PASSIVE_LEVEL
Windows
DrmGetContentRights
drmk/DrmGetContentRights
APIRef
kbSyntax
LibDef
Drmk.lib
Drmk.dll
DrmGetContentRights

DrmGetContentRights function

-description

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

-parameters

-param ContentId [in]

Specifies the DRM content ID. This parameter identifies a KS audio stream.

-param 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.

-returns

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.

-see-also

DRMRIGHTS

DrmAddContentHandlers

DrmCreateContentMixed

DrmForwardContentToDeviceObject

DrmForwardContentToInterface

IDrmAudioStream::SetContentId

IDrmPort::GetContentRights

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcGetContentRights