DrmGetContentRights-Funktion (drmk.h)

Artikel
03/05/2024

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

[out] DrmRights

Gibt die DRM-Inhaltsberechtigungen an, die dem stream zugewiesen werden, der durch ContentId identifiziert wird. Dieser Parameter ist ein Zeiger auf eine DRMRIGHTS-Struktur .

Rückgabewert

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

Hinweise

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

Ein Modul, das nach dem KS-Filter liegt, der die Inhalts-ID erstellt, muss in der Regel nicht aufrufen DrmGetContentRights. Stattdessen empfängt das Modul sowohl die Inhalts-ID als auch die Inhaltsberechtigungen entweder vom System (über einen IDrmAudioStream::SetContentId-Aufruf oder eine KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDSet-Property-Anforderung) oder direkt vom vorherigen Modul im Datenpfad (über einen Aufruf eines Inhaltshandlers). Weitere Informationen finden Sie unter DrmForwardContentToInterface, DrmForwardContentToDeviceObject und DrmAddContentHandlers.

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