Função DrmGetContentRights (drmk.h)

Artigo
02/26/2024

A DrmGetContentRights função 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 identificado pelo ContentId. Esse parâmetro é um ponteiro para uma estrutura DRMRIGHTS .

Retornar valor

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

Comentários

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 que o sistema atribuiu 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 uma chamada IDrmAudioStream::SetContentId ou uma KSPROPERTY_DRMAUDIOSTREAM_CONTENTIDsolicitação set-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, DrmForwardContentToDeviceObject e DrmAddContentHandlers.

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