Função DrmForwardContentToFileObject (drmk.h)
A função DrmForwardContentToFileObject é 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.
Valor de retorno
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 |
|---|---|
|
Indica que o pin de áudio KS associado a FileObject não dá suporte aos direitos de conteúdo drm atribuídos a ContentId. |
Observações
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 de DRM mais baixo. Em vez disso, novos drivers devem chamar DrmForwardContentToDeviceObject.
A função DrmForwardContentToFileObject 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 de DRMRIGHTS.
DrmForwardContentToFileObject não usa FileObject após o retorno.
DrmForwardContentToFileObject executa a mesma função que pcForwardContentToFileObject e IDrmPort::ForwardContentToFileObject. Para obter mais informações, consulte de funções e interfaces do DRM.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | drmk.h (inclua Drmk.h) |
| biblioteca | Drmk.lib |
| IRQL | PASSIVE_LEVEL |
Consulte também
DrmForwardContentToDeviceObject
IDrmPort::ForwardContentToFileObject