Método IDrmAudioStream::SetContentId (drmk.h)
El método SetContentId 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 por DRM en esta secuencia.
[in] DrmRights
Puntero a una estructura de 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.
Observaciones
El sistema DRM puede llamar al método SetContentId 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 método SetContentId sincrónicamente. 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 de bajada 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 método SetContentId 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, vea Digital Rights Management.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | drmk.h (incluya Drmk.h) |
| irQL | PASSIVE_LEVEL |