Função DrmGetContentRights (drmk.h)

Artigo
02/06/2025

A função DrmGetContentRights recupera os direitos de conteúdo drm atribuídos a uma ID de conteúdo drm.

Sintaxe

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

Parâmetros

[in] ContentId

Especifica a ID de conteúdo drm. Esse parâmetro identifica um fluxo de áudio KS.

[out] DrmRights

Especifica os direitos de conteúdo drm atribuídos ao fluxo que é identificado por ContentId. Esse parâmetro é um ponteiro para uma estrutura de DRMRIGHTS.

Valor de retorno

DrmGetContentRights retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Observações

Antes que um filtro de áudio KS comece a misturar vários fluxos de áudio KS, ele primeiro chama DrmCreateContentMixed para criar uma ID de conteúdo para o fluxo composto. Em seguida, ele chama DrmGetContentRights para obter os direitos de conteúdo atribuídos pelo sistema ao fluxo.

Um módulo que fica downstream do filtro KS que cria a ID de conteúdo normalmente não precisa chamar DrmGetContentRights. Em vez disso, o módulo recebe a ID de conteúdo e os direitos de conteúdo do sistema (por meio de um IDrmAudioStream::SetContentId chamada ou uma solicitação KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDset-property) ou diretamente do módulo anterior no caminho de dados (por meio de uma chamada para um manipulador de conteúdo). Para obter mais informações, consulte DrmForwardContentToInterface, DrmForwardContentToDeviceObjecte DrmAddContentHandlers.

DrmGetContentRights executa a mesma função que PcGetContentRights e IDrmPort::GetContentRights. Para obter mais informações, consulte de funções e interfaces do DRM.