Función DrmForwardContentToFileObject (drmk.h)

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.

Observaciones

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.

Requisitos

   
Plataforma de destino Universal
Header drmk.h (incluye Drmk.h)
Library Drmk.lib
IRQL PASSIVE_LEVEL

Consulte también

DRMRIGHTS

DrmForwardContentToDeviceObject

IDrmPort::ForwardContentToFileObject

KSPROPERTY_DRMAUDIOSTREAM_CONTENTID

PcForwardContentToFileObject