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

Artigo
02/26/2024

O SetContentId método 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 nesse fluxo.

[in] DrmRights

Ponteiro para uma estrutura DRMRIGHTS que especifica os direitos concedidos pelo provedor de conteúdo ao usuário para reproduzir e copiar conteúdo protegido por DRM neste fluxo.

Retornar valor

SetContentId retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna 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.

Comentários

O sistema DRM pode chamar o método a SetContentId 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 SetContentId método 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 os direitos de conteúdo de ID de conteúdo drm e drm especificados. (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 drm especificados, o SetContentId método retornará o código de erro STATUS_NOT_IMPLEMENTED. Nesse caso, os direitos de conteúdo DRM e ID de conteúdo drm definidos anteriormente pelo fluxo de áudio do KS permanecem definidos no fluxo.

Para obter mais informações sobre como usar esse método, confira Gerenciamento de Direitos Digitais.