Compartilhar via

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL função de retorno de chamada (d3d10umddi.h)

  • Artigo

Processa uma solicitação de um aplicativo para configurar um canal autenticado para proteção de conteúdo. Implementado por um driver de exibição WDDM (Modelo de Driver de Exibição do Windows) 1.2 ou posterior.

Sintaxe

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;

HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

hCAuthChannel

Um identificador para o objeto de canal autenticado que foi criado por meio de uma chamada para a função CreateAuthenticatedChannel(D3D11_1).

InputDataSize

O tamanho, em bytes, da matriz especificada pelo parâmetro pInputData .

pInputData

Um ponteiro para uma matriz de bytes que contém dados de entrada para o comando. Para obter mais informações, consulte a seção Comentários.

pOutputData

Um ponteiro para uma estrutura D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT . Para obter mais informações, consulte a seção Comentários.

Retornar valor

Retorna um dos seguintes valores:

Código de retorno Descrição
S_OK O canal autenticado foi configurado com êxito.
E_FAIL O driver de miniporta de exibição não dá suporte ao comando especificado
E_INVALIDARG Os parâmetros foram validados e determinados como incorretos.
E_OUTOFMEMORY A memória não estava disponível para concluir a operação.

Comentários

A matriz de bytes referenciada pelo parâmetro pInputData é formatada da seguinte maneira:

A lista a seguir descreve o formato desses dados com base no membro ConfigureType .

A estrutura D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT contém um código de autenticação de mensagem CBC de uma chave (OMAC) baseado em AES dos dados. O driver de miniporta de exibição deve calcular seu próprio OMAC sobre os dados para autenticar os dados. Essa estrutura de entrada também contém um identificador de driver para o canal autenticado, um número de sequência e um GUID que indica o tipo de configuração.

O driver de miniporta de exibição segue estas etapas quando inicializa a estrutura D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT :

  1. O driver deve copiar os dados de entrada para a estrutura D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT .

  2. O driver deve definir o membro ReturnCode para o mesmo código de retorno que retornará para a chamada ConfigureAuthenticatedChannel(D3D11_1). Isso fornece ao aplicativo um mecanismo seguro de acesso ao código de retorno.

  3. O driver define o membro omac como zero e calcula um OMAC para os dados na estrutura. Em seguida, o driver define o membro omac como o OMAC que ele calculou

O driver de miniporto de exibição deve retornar E_INVALIDARG para a chamada ConfigureAuthenticatedChannel nas seguintes condições:

  • O membro omac da estruturaD3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT não corresponde ao OMAC calculado pelo driver.

  • O número de sequência não é maior que um número de sequência especificado em uma chamada de configuração anterior.

  • O número de sequência ainda não foi inicializado por uma chamada para a função ConfigureAuthenticatedChannel(D3D11_1).

  • O parâmetro InputDataSize é menor que o tamanho da estrutura D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT mais o tamanho da estrutura especificada pelo D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT. ConfigureTypemember.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT