Content IDs and Content Rights

A content ID (identifier) is a ULONG value that the DRMK system driver generates at runtime to identify DRM-protected content in the audio-data stream that feeds into a particular pin.

Content rights are a digital representation of the rights granted by the content provider to the user for playing and copying DRM-protected content. Content rights are specified in the form of a DRMRIGHTS structure that DRMK passes to the audio driver.

DRMRIGHTS contains two flags: DigitalOutputDisable and CopyProtect. If the DigitalOutputDisable flag is set, the driver must disable any digital outputs that connect to external devices (through an S/PDIF connector, for example). If the CopyProtect flag is set, the driver must disable features that might allow a persistent copy of the secure content to be saved to disk or to any other form of nonvolatile storage. For example, typical audio hardware allows a playback signal to be routed through the capture channel. If this signal is in digital form, the captured signal may be a perfect digital copy of the input signal. If the playback mix contains data from any stream that has a CopyProtect flag set, the driver must mute the playback-capture path.

A DRM-compliant audio driver must support the IDrmAudioStream interface on its WaveCyclic and WavePci miniport driver objects, which expose sink pins for rendering audio data. In order to obtain a reference to an IDrmAudioStream object from the driver, DRMK calls the QueryInterface method on the pin. The pin has an interface of type IMiniportWaveCyclicStream or IMiniportWavePciStream. The IDrmAudioStream interface supports only one method, IDrmAudioStream::SetContentId (in addition to the three IUnknown methods). When DRMK calls SetContentId, it passes in a content ID and content rights, which the driver associates with the pin's data stream.

Instead of calling the DRM functions in Drmk.sys directly, a WaveCyclic or WavePci miniport driver can access the DRM functions through the IDrmPort2 interface (IDrmPort2 is derived from base class IDrmPort). In Microsoft Windows XP and later, the WaveCyclic and WavePci port drivers support IDrmPort2. The miniport driver obtains a reference to the port driver's IDrmPort2 interface by calling the port object's QueryInterface method with REFIID IID_IDrmPort2.

Some audio drivers support hardware mixing and can handle several input data streams at the same time. This type of driver must keep track of both the content IDs for the individual streams and the composite content rights of all the streams. The driver calls IDrmPort::CreateContentMixed to determine the composite rights for a mixed stream and to create a content ID to identify that stream. When the driver finishes using the content ID, it must call IDrmPort::DestroyContent to delete the content ID.

Each time an input stream is added to or removed from a mixer, the driver must delete the content ID for the old mix and create a new content ID for the new mix. Before deleting an old content ID, the driver must first successfully forward a new content ID to all the streams to which it previously forwarded the old content ID. For more information, see Forwarding DRM Content IDs.