DrmGetContentRights, fonction (drmk.h)

Article
02/06/2025

La fonction DrmGetContentRights 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 affectés au flux identifié par ContentId. Ce paramètre est un pointeur vers une structure DRMRIGHTS.

Valeur de retour

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 à partir 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 IDrmAudioStream ::SetContentId appel ou une demande de propriété définie 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, DrmForwardContentToDeviceObjectet DrmAddContentHandlers.

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