Funzione DrmForwardContentToFileObject (drmk.h)

Articolo
02/26/2024

La DrmForwardContentToFileObject funzione è 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.

Commenti

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

La DrmForwardContentToFileObject funzione autentica il filtro audio KS che implementa il pin audio KS rappresentato da FileObject. Se DrmForwardContentToFileObject il filtro audio KS viene autenticato correttamente, imposta la proprietà KS KSPROPERTY_DRMAUDIOSTREAM_CONTENTID sul pin audio rappresentato da FileObject. I dati della 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 e interfacce DRM.