Méthode IDrmAudioStream ::SetContentId (drmk.h)

Article
02/29/2024

La SetContentId méthode définit l’ID de contenu DRM et ses droits de contenu DRM attribués sur un flux audio KS.

Syntaxe

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

Paramètres

[in] ContentId

Spécifie l’ID de contenu DRM. Ce paramètre est un identificateur que le système DRM génère au moment de l’exécution pour identifier le contenu protégé par DRM dans ce flux.

[in] DrmRights

Pointeur vers une structure DRMRIGHTS spécifiant les droits accordés par le fournisseur de contenu à l’utilisateur pour lire et copier du contenu protégé par DRM dans ce flux.

Valeur retournée

SetContentId retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié. Si le filtre ne peut pas appliquer les droits de contenu spécifiés, la méthode retourne STATUS_NOT_IMPLEMENTED.

Remarques

Le système DRM peut appeler la SetContentId méthode à tout moment pendant la durée de vie d’un flux audio KS.

Un filtre audio KS termine l’exécution d’un appel à la SetContentId méthode de manière synchrone. Si la fonction retourne STATUS_SUCCESS, cela indique que tous les nœuds audio KS en aval (voir Nœuds de topologie audio) d’un flux audio KS ont également été correctement configurés avec l’ID de contenu DRM et les droits de contenu DRM spécifiés. (Le terme nœud en aval fait référence à un récepteur direct ou indirect pour un flux audio.)

Si le filtre audio KS ne peut pas appliquer les droits de contenu DRM spécifiés, la SetContentId méthode retourne le code d’erreur STATUS_NOT_IMPLEMENTED. Dans ce cas, l’ID de contenu DRM et les droits de contenu DRM du flux audio KS précédemment définis restent définis sur le flux.

Pour plus d’informations sur l’utilisation de cette méthode, consultez Digital Rights Management.