Función DrmGetContentRights (drmk.h)

Artículo
08/07/2023

La DrmGetContentRights función recupera los derechos de contenido drm asignados a un identificador de contenido DRM.

Sintaxis

NTSTATUS DrmGetContentRights(
  [in]  ULONG      ContentId,
  [out] PDRMRIGHTS DrmRights
);

Parámetros

[in] ContentId

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

[out] DrmRights

Especifica los derechos de contenido drm que se asignan a la secuencia identificada por ContentId. Este parámetro es un puntero a una estructura DRMRIGHTS .

Valor devuelto

DrmGetContentRights devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

Antes de que un filtro de audio KS comience a mezclar varias secuencias de audio KS, primero llama a DrmCreateContentMixed para crear un identificador de contenido para la secuencia compuesta. A continuación, llama DrmGetContentRights a para obtener los derechos de contenido que el sistema ha asignado a la secuencia.

Un módulo que se encuentra de bajada del filtro KS que crea el identificador de contenido normalmente no necesita llamar DrmGetContentRightsa . En su lugar, el módulo recibe tanto el identificador de contenido como los derechos de contenido del sistema (a través de una llamada IDrmAudioStream::SetContentId o una solicitud de KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property) o directamente desde el módulo anterior en la ruta de acceso de datos (a través de una llamada a un controlador de contenido). Para obtener más información, vea DrmForwardContentToInterface, DrmForwardContentToDeviceObject y DrmAddContentHandlers.

DrmGetContentRights realiza la misma función que PcGetContentRights e IDrmPort::GetContentRights. Para obtener más información, consulte Funciones e interfaces drm.