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 [dentro, fora]
Um ponteiro para uma estrutura de 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.
Valor de retorno
ConfigureAuthenticatedChannel retorna um dos seguintes valores:
| Código de retorno | descrição |
|---|---|
| S_OK | O canal autenticado é configurado com êxito. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel não pôde alocar a memória necessária para que ela fosse concluída. |
Observações
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 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 esta ú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 OPM (Output Protection Manager).
Com exceção das 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 |
|---|---|
| de cliente com suporte mínimo | Há suporte para ConfigureAuthenticatedChannel a partir do sistema operacional Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |