Método IDrmAudioStream::SetContentId (drmk.h)
O método SetContentId define a ID de conteúdo drm e seus direitos de conteúdo drm atribuídos em um fluxo de áudio KS.
Sintaxe
NTSTATUS SetContentId(
[in] ULONG ContentId,
[in] PCDRMRIGHTS DrmRights
);
Parâmetros
[in] ContentId
Especifica a ID de conteúdo drm. Esse parâmetro é um identificador que o sistema DRM gera em tempo de execução para identificar o conteúdo protegido por DRM neste fluxo.
[in] DrmRights
Ponteiro para uma estrutura DRMRIGHTS especificando os direitos concedidos pelo provedor de conteúdo ao usuário para reproduzir e copiar conteúdo protegido por DRM neste fluxo.
Valor de retorno
SetContentId retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro apropriado. Se o filtro não puder impor os direitos de conteúdo especificados, o método retornará STATUS_NOT_IMPLEMENTED.
Observações
O sistema DRM pode chamar o método SetContentId a qualquer momento durante o tempo de vida de um fluxo de áudio KS.
Um filtro de áudio KS conclui a execução de uma chamada para o método SetContentId de forma síncrona. Se a função retornar STATUS_SUCCESS, isso indicará que todos os nós de áudio KS downstream (consulte Nós de Topologia de Áudio) de um fluxo de áudio KS também foram configurados com êxito com a ID de conteúdo drm especificada e os direitos de conteúdo drm. (O termo nó downstream refere-se a um coletor direto ou indireto para um fluxo de áudio.)
Se o filtro de áudio KS não puder impor os direitos de conteúdo de DRM especificados, o método SetContentId retornará o código de erro STATUS_NOT_IMPLEMENTED. Nesse caso, a ID de conteúdo drm definida anteriormente pelo fluxo de áudio KS e os direitos de conteúdo drm permanecem definidos no fluxo.
Para obter mais informações sobre como usar esse método, consulte do Digital Rights Management.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | drmk.h (inclua Drmk.h) |
| IRQL | PASSIVE_LEVEL |