IDrmAudioStream::SetContentId-Methode (drmk.h)

Artikel
03/05/2024

Die SetContentId -Methode legt die DRM-Inhalts-ID und die zugewiesenen DRM-Inhaltsrechte für einen KS-Audiodatenstrom fest.

Syntax

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

Parameter

[in] ContentId

Gibt die DRM-Inhalts-ID an. Dieser Parameter ist ein Bezeichner, den das DRM-System zur Laufzeit generiert, um DRM-geschützte Inhalte in diesem Stream zu identifizieren.

[in] DrmRights

Zeiger auf eine DRMRIGHTS-Struktur , die die Rechte angibt, die der Inhaltsanbieter dem Benutzer zum Wiedergeben und Kopieren von DRM-geschützten Inhalten in diesem Stream gewährt.

Rückgabewert

SetContentId gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück. Wenn der Filter die angegebenen Inhaltsrechte nicht erzwingen kann, gibt die Methode STATUS_NOT_IMPLEMENTED zurück.

Hinweise

Das DRM-System kann die SetContentId -Methode jederzeit während der Lebensdauer eines KS-Audiostreams aufrufen.

Ein KS-Audiofilter schließt die Ausführung eines Aufrufs der SetContentId -Methode synchron ab. Wenn die Funktion STATUS_SUCCESS zurückgibt, gibt dies an, dass alle nachgeschalteten KS-Audioknoten (siehe Audiotopologieknoten) eines KS-Audiostreams ebenfalls erfolgreich mit der angegebenen DRM-Inhalts-ID und DRM-Inhaltsberechtigungen konfiguriert wurden. (Der Begriff Downstreamknoten bezieht sich entweder auf eine direkte oder eine indirekte Senke für einen Audiodatenstrom.)

Wenn der KS-Audiofilter die angegebenen DRM-Inhaltsrechte nicht erzwingen kann, gibt die SetContentId Methode den Fehlercode STATUS_NOT_IMPLEMENTED zurück. In diesem Fall bleiben die zuvor festgelegten DRM-Inhalts-ID und DRM-Inhaltsrechte des KS-Audiostreams im Stream festgelegt.

Weitere Informationen zur Verwendung dieser Methode finden Sie unter Digital Rights Management.