DrmForwardContentToFileObject, fonction (drmk.h)

La DrmForwardContentToFileObject fonction est obsolète et est conservée uniquement pour prendre en charge les pilotes existants. Cette fonction envoie au système d’exploitation un objet de fichier représentant un appareil qui gère le contenu protégé. Il transfère également à l’appareil spécifié l’ID de contenu et les droits DRM associés d’un flux contenant du contenu protégé.

Syntaxe

NTSTATUS DrmForwardContentToFileObject(
  [in] ULONG        ContentId,
  [in] PFILE_OBJECT FileObject
);

Paramètres

[in] ContentId

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

[in] FileObject

Pointeur vers un objet de fichier qui représente l’épingle audio KS à laquelle le flux audio KS est envoyé.

Valeur de retour

DrmForwardContentToFileObject retourne STATUS_SUCCESS si l’appel a réussi. Le tableau suivant présente certaines valeurs de retour d’erreur possibles.

Code de retour Description
STATUS_NOT_IMPLEMENTED
Indique que la broche audio KS associée à FileObject ne prend pas en charge les droits de contenu DRM affectés à ContentId.

Remarques

Cette fonction est remplacée par DrmForwardContentToDeviceObject. Un pilote qui appelle DrmForwardContentToFileObject force le système à s’exécuter à un niveau de sécurité DRM inférieur. Les nouveaux pilotes doivent appeler DrmForwardContentToDeviceObject à la place.

La DrmForwardContentToFileObject fonction authentifie le filtre audio KS qui implémente l’épingle audio KS représentée par FileObject. S’il DrmForwardContentToFileObject authentifie correctement le filtre audio KS, il définit la propriété KS KSPROPERTY_DRMAUDIOSTREAM_CONTENTID sur la broche audio représentée par FileObject. Les données de propriété incluent un ID de contenu DRM et une structure DRMRIGHTS . DrmForwardContentToFileObject n’utilise pas FileObject après le retour.

DrmForwardContentToFileObject exécute la même fonction que PcForwardContentToFileObject et IDrmPort::ForwardContentToFileObject. Pour plus d’informations, consultez fonctions et interfaces DRM.

Configuration requise

   
Plateforme cible Universal
En-tête drmk.h (inclure Drmk.h)
Bibliothèque Drmk.lib
IRQL PASSIVE_LEVEL

Voir aussi

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject