Método IDrmAudioStream::SetContentId (drmk.h)

Artículo
02/29/2024

El SetContentId método establece el identificador de contenido drm y sus derechos de contenido DRM asignados en una secuencia de audio KS.

Sintaxis

NTSTATUS SetContentId(
  [in] ULONG       ContentId,
  [in] PCDRMRIGHTS DrmRights
);

Parámetros

[in] ContentId

Especifica el identificador de contenido drm. Este parámetro es un identificador que el sistema DRM genera en tiempo de ejecución para identificar el contenido protegido con DRM en esta secuencia.

[in] DrmRights

Puntero a una estructura DRMRIGHTS que especifica los derechos concedidos por el proveedor de contenido al usuario para reproducir y copiar contenido protegido con DRM en esta secuencia.

Valor devuelto

SetContentId devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado. Si el filtro no puede aplicar los derechos de contenido especificados, el método devuelve STATUS_NOT_IMPLEMENTED.

Comentarios

El sistema DRM puede llamar al SetContentId método en cualquier momento durante la vigencia de una secuencia de audio KS.

Un filtro de audio KS completa la ejecución de una llamada al SetContentId método de forma sincrónica. Si la función devuelve STATUS_SUCCESS, esto indica que todos los nodos de audio KS de bajada (consulte Nodos de topología de audio) de una secuencia de audio KS también se han configurado correctamente con el identificador de contenido DRM y los derechos de contenido DRM especificados. (El término nodo descendente hace referencia a un receptor directo o indirecto para una secuencia de audio).

Si el filtro de audio KS no puede aplicar los derechos de contenido DRM especificados, el SetContentId método devuelve el código de error STATUS_NOT_IMPLEMENTED. En este caso, la secuencia de audio KS estableció previamente el identificador de contenido DRM y los derechos de contenido drm permanecen establecidos en la secuencia.

Para obtener más información sobre el uso de este método, consulte Digital Rights Management.