PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL função de retorno de chamada (d3dumddi.h)
A função ConfigureAuthenticatedChannel define o estado em um canal autenticado.
Sintaxe
PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;
HRESULT Pfnd3dddiConfigureauthenicatedchannel(
HANDLE hDevice,
const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
pData [in, out]
Um ponteiro para uma estrutura D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL que descreve como configurar um canal autenticado. Essa estrutura contém um buffer de entrada que descreve como configurar o canal autenticado e um buffer de saída com informações de configuração.
Retornar valor
ConfigureAuthenticatedChannel retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O canal autenticado foi configurado com êxito. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel não pôde alocar a memória necessária para que ela fosse concluída. |
Comentários
O buffer de entrada contém um código de autenticação de mensagem do modo CBC (Encadeamento de Blocos de Criptografia de Uma Chave) que o driver deve autenticar. O buffer de entrada também contém o identificador do driver para o canal autenticado, um número de sequência e um GUID que indica o tipo de configuração.
O driver deverá falhar em ConfigureAuthenticatedChannel se o OMAC de entrada não corresponder, se o número de sequência não for maior que um número de sequência especificado em uma chamada anterior ou se o número de sequência ainda não tiver sido inicializado (a exceção a essa última regra é para a chamada de inicialização em si).
O driver deve duplicar os dados de entrada na estrutura do buffer de saída e deve assinar a estrutura de saída de forma idêntica à maneira como ele lida atualmente com consultas do OPM ( Output Protection Manager ).
Exceto para as situações em que o aplicativo especifica incorretamente um buffer de saída muito pequeno, o driver sempre deve colocar o código de retorno na estrutura de saída. Portanto, o aplicativo tem um mecanismo seguro para determinar o código de retorno.
ConfigureAuthenticatedChannel executa operações diferentes dependendo de cada um dos GUIDs a seguir especificados na estrutura de entrada. O driver deverá falhar se o tamanho do buffer de entrada não corresponder ao tamanho definido para o GUID especificado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | ConfigureAuthenticatedChannel tem suporte a partir do sistema operacional Windows 7. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |