DrmForwardContentToFileObject, fonction (drmk.h)

Article
02/06/2025

La fonction DrmForwardContentToFileObject 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 des valeurs de retour d’erreur possibles.

Retourner le code	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 fonction DrmForwardContentToFileObject authentifie le filtre audio KS qui implémente la broche audio KS représentée par FileObject. Si 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 effectue la même fonction que PcForwardContentToFileObject et IDrmPort ::ForwardContentToFileObject. Pour plus d’informations, consultez fonctions et interfaces DRM.