IDrmAudioStream ::SetContentId, méthode (drmk.h)
La méthode SetContentId 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 de retour
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 méthode SetContentId à 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 méthode SetContentId 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 méthode SetContentId retourne le code d’erreur STATUS_NOT_IMPLEMENTED. Dans ce cas, l’ID de contenu DRM défini précédemment par le flux audio KS et les droits de contenu DRM restent définis sur le flux.
Pour plus d’informations sur l’utilisation de cette méthode, consultez Digital Rights Management.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | drmk.h (include Drmk.h) |
| IRQL | PASSIVE_LEVEL |