Función DrmForwardContentToFileObject (drmk.h)

Artículo
02/29/2024

La DrmForwardContentToFileObject función está obsoleta y solo se mantiene para admitir controladores existentes. Esta función envía al sistema operativo un objeto de archivo que representa un dispositivo que controla el contenido protegido. También reenvía al dispositivo especificado el identificador de contenido y los derechos DRM asociados de una secuencia que contiene contenido protegido.

Sintaxis

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

Parámetros

[in] ContentId

Especifica el identificador de contenido drm. Este parámetro identifica una secuencia de audio KS protegida.

[in] FileObject

Puntero a un objeto de archivo que representa la patilla de audio KS a la que se envía la secuencia de audio KS.

Valor devuelto

DrmForwardContentToFileObject devuelve STATUS_SUCCESS si la llamada se realizó correctamente. En la tabla siguiente se muestran algunos de los posibles valores devueltos de error.

Código devuelto	Descripción
STATUS_NOT_IMPLEMENTED	Indica que el pin de audio KS asociado a FileObject no admite los derechos de contenido drm asignados a ContentId.

Comentarios

Esta función se sustituye por DrmForwardContentToDeviceObject. Un controlador que llama a DrmForwardContentToFileObject obliga al sistema a ejecutarse en un nivel de seguridad drm inferior. Los nuevos controladores deben llamar a DrmForwardContentToDeviceObject en su lugar.

La DrmForwardContentToFileObject función autentica el filtro de audio KS que implementa el pin de audio KS representado por FileObject. Si DrmForwardContentToFileObject autentica correctamente el filtro de audio KS, establece la propiedad KS KSPROPERTY_DRMAUDIOSTREAM_CONTENTID en el pin de audio representado por FileObject. Los datos de propiedad incluyen un identificador de contenido DRM y una estructura DRMRIGHTS . DrmForwardContentToFileObject no hace uso de FileObject después de devolver.

DrmForwardContentToFileObject realiza la misma función que PcForwardContentToFileObject e IDrmPort::ForwardContentToFileObject. Para obtener más información, consulte Funciones e interfaces drm.