DrmGetContentRights-Funktion (drmk.h)

Artikel
02/06/2025

Die DrmGetContentRights-Funktion ruft die DRM-Inhaltsberechtigungen ab, die einer DRM-Inhalts-ID zugewiesen sind.

Syntax

NTSTATUS DrmGetContentRights(
  [in]  ULONG      ContentId,
  [out] PDRMRIGHTS DrmRights
);

Parameter

[in] ContentId

Gibt die DRM-Inhalts-ID an. Dieser Parameter identifiziert einen KS-Audiodatenstrom.

[out] DrmRights

Gibt die DRM-Inhaltsrechte an, die dem Datenstrom zugewiesen sind, der durch ContentId-identifiziert wird. Dieser Parameter ist ein Zeiger auf eine DRMRIGHTS--Struktur.

Rückgabewert

DrmGetContentRights gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

Bevor ein KS-Audiofilter mit dem Mischen mehrerer KS-Audiodatenströme beginnt, ruft er zunächst DrmCreateContentMixed auf, um eine Inhalts-ID für den zusammengesetzten Datenstrom zu erstellen. Als Nächstes ruft sie DrmGetContentRights auf, um die Inhaltsrechte abzurufen, die das System dem Datenstrom zugewiesen hat.

Ein Modul, das vom KS-Filter nachgeschaltet ist, der die Inhalts-ID erstellt, muss in der Regel keine DrmGetContentRightsaufrufen. Stattdessen empfängt das Modul sowohl die Inhalts-ID als auch die Inhaltsberechtigungen vom System (über einen IDrmAudioStream::SetContentId Aufruf oder eine KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDSet-Property-Anforderung) oder direkt vom vorherigen Modul im Datenpfad (über einen Aufruf an einen Inhaltshandler). Weitere Informationen finden Sie unter DrmForwardContentToInterface, DrmForwardContentToDeviceObjectund DrmAddContentHandlers.

DrmGetContentRights führt dieselbe Funktion wie PcGetContentRights und IDrmPort::GetContentRightsaus. Weitere Informationen finden Sie unter DRM-Funktionen und -Schnittstellen.