Funzione DrmForwardContentToFileObject (drmk.h)

Articolo
02/06/2025

La funzione DrmForwardContentToFileObject è obsoleta e viene mantenuta solo per supportare i driver esistenti. Questa funzione invia al sistema operativo un oggetto file che rappresenta un dispositivo che gestisce il contenuto protetto. Inoltra anche al dispositivo specificato l'ID contenuto e i diritti DRM associati di un flusso contenente contenuto protetto.

Sintassi

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

Parametri

[in] ContentId

Specifica l'ID contenuto DRM. Questo parametro identifica un flusso audio KS protetto.

[in] FileObject

Puntatore a un oggetto file che rappresenta il pin audio KS a cui viene inviato il flusso audio KS.

Valore restituito

DrmForwardContentToFileObject restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. La tabella seguente illustra alcuni dei possibili valori restituiti dall'errore.

Codice restituito	Descrizione
STATUS_NOT_IMPLEMENTED	Indica che il pin audio KS associato a FileObject non supporta i diritti di contenuto DRM assegnati a ContentId.

Osservazioni

Questa funzione viene sostituita da DrmForwardContentToDeviceObject. Un driver che chiama DrmForwardContentToFileObject forza l'esecuzione del sistema a un livello di sicurezza DRM inferiore. I nuovi driver devono invece chiamare DrmForwardContentToDeviceObject.

La funzione DrmForwardContentToFileObject autentica il filtro audio KS che implementa il pin audio KS rappresentato da FileObject. Se DrmForwardContentToFileObject autentica correttamente il filtro audio KS, imposta la proprietà KS KSPROPERTY_DRMAUDIOSTREAM_CONTENTID sul pin audio rappresentato da FileObject. I dati delle proprietà includono un ID contenuto DRM e una struttura DRMRIGHTS. DrmForwardContentToFileObject non usa FileObject dopo la restituzione.

DrmForwardContentToFileObject esegue la stessa funzione di PcForwardContentToFileObject e IDrmPort::ForwardContentToFileObject. Per altre informazioni, vedere funzioni DRM e interfacce.