DrmGetContentRights, fonction (drmk.h)

Article
02/29/2024

La DrmGetContentRights fonction récupère les droits de contenu DRM attribués à un ID de contenu DRM.

Syntaxe

NTSTATUS DrmGetContentRights(
  [in]  ULONG      ContentId,
  [out] PDRMRIGHTS DrmRights
);

Paramètres

[in] ContentId

Spécifie l’ID de contenu DRM. Ce paramètre identifie un flux audio KS.

[out] DrmRights

Spécifie les droits de contenu DRM attribués au flux identifié par ContentId. Ce paramètre est un pointeur vers une structure DRMRIGHTS .

Valeur retournée

DrmGetContentRights retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.

Remarques

Avant qu’un filtre audio KS commence à mélanger plusieurs flux audio KS, il appelle d’abord DrmCreateContentMixed pour créer un ID de contenu pour le flux composite. Ensuite, il appelle DrmGetContentRights pour obtenir les droits de contenu que le système a attribués au flux.

Un module qui se trouve en aval du filtre KS qui crée l’ID de contenu n’a généralement pas besoin d’appeler DrmGetContentRights. Au lieu de cela, le module reçoit à la fois l’ID de contenu et les droits de contenu du système (via un appel IDrmAudioStream ::SetContentId ou une requête set-property KSPROPERTY_DRMAUDIOSTREAM_CONTENTID) ou directement à partir du module précédent dans le chemin des données (via un appel à un gestionnaire de contenu). Pour plus d’informations, consultez DrmForwardContentToInterface, DrmForwardContentToDeviceObject et DrmAddContentHandlers.

DrmGetContentRights remplit la même fonction que PcGetContentRights et IDrmPort ::GetContentRights. Pour plus d’informations, consultez Fonctions et interfaces DRM.