DrmForwardContentToFileObject, fonction (drmk.h)

Article
02/26/2024

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 fichier qui représente la broche audio KS à laquelle le flux audio KS est envoyé.

Valeur retournée

DrmForwardContentToFileObject retourne STATUS_SUCCESS si l’appel a réussi. Le tableau suivant présente certaines des 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 attribué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 la broche 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.