Função DrmForwardContentToFileObject (drmk.h)

Artigo
02/29/2024

A DrmForwardContentToFileObject função é obsoleta e é mantida apenas para dar suporte a drivers existentes. Essa função envia ao sistema operacional um objeto de arquivo que representa um dispositivo que manipula o conteúdo protegido. Ele também encaminha para o dispositivo especificado a ID de conteúdo e os direitos de DRM associados de um fluxo que contém conteúdo protegido.

Sintaxe

NTSTATUS DrmForwardContentToFileObject(
  [in] ULONG        ContentId,
  [in] PFILE_OBJECT FileObject
);

Parâmetros

[in] ContentId

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

[in] FileObject

Ponteiro para um objeto de arquivo que representa o pino de áudio KS para o qual o fluxo de áudio KS é enviado.

Retornar valor

DrmForwardContentToFileObject retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. A tabela a seguir mostra alguns dos valores de retorno de erro possíveis.

Código de retorno	Descrição
STATUS_NOT_IMPLEMENTED	Indica que o pino de áudio KS associado ao FileObject não dá suporte aos direitos de conteúdo DRM atribuídos ao ContentId.

Comentários

Essa função é substituída por DrmForwardContentToDeviceObject. Um driver que chama DrmForwardContentToFileObject força o sistema a ser executado em um nível de segurança drm mais baixo. Em vez disso, os novos drivers devem chamar DrmForwardContentToDeviceObject .

A DrmForwardContentToFileObject função autentica o filtro de áudio KS que implementa o pino de áudio KS representado por FileObject. Se DrmForwardContentToFileObject autenticar com êxito o filtro de áudio KS, ele definirá a propriedade KS KSPROPERTY_DRMAUDIOSTREAM_CONTENTID no pino de áudio representado por FileObject. Os dados da propriedade incluem uma ID de conteúdo DRM e uma estrutura DRMRIGHTS . DrmForwardContentToFileObject não usa FileObject depois de retornar.

DrmForwardContentToFileObject executa a mesma função que PcForwardContentToFileObject e IDrmPort::ForwardContentToFileObject. Para obter mais informações, consulte Funções e interfaces drm.