IDrmAudioStream::SetContentId-Methode (drmk.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | drmk.h (drmk.h einschließen) |
| IRQL | PASSIVE_LEVEL |