PFND3DDDI_CREATEAUTHENTICATEDCHANNEL função de retorno de chamada (d3dumddi.h)

  • Artigo

A função CreateAuthenticatedChannel cria um canal que o runtime do Microsoft Direct3D e o driver podem usar para definir e consultar proteções.

Sintaxe

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

HRESULT Pfnd3dddiCreateauthenticatedchannel(
  HANDLE hDevice,
  D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *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_CREATEAUTHENTICATEDCHANNEL . Na entrada, essa estrutura contém informações que o driver pode usar. Na saída, o driver especifica informações na estrutura que o runtime do Direct3D pode usar.

Retornar valor

CreateAuthenticatedChannel retorna um dos seguintes valores:

Código de retorno Descrição
S_OK O canal foi criado com êxito.
E_OUTOFMEMORY CreateAuthenticatedChannel não pôde alocar a memória necessária para que ela fosse concluída.
D3DDDIERR_NOTAVAILABLE O driver não dá suporte ao tipo de canal especificado no membro ChannelType da estrutura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL para a qual o parâmetro pData aponta.

Comentários

O runtime passa o identificador para o canal autenticado que o driver retorna no membro ChannelType da estrutura D3DDDIARG_CREATEAUTHENTICATEDCHANNEL em todas as chamadas subsequentes que exigem o identificador.

O driver deve acompanhar o dispositivo de exibição (hDevice) que foi usado para criar o canal autenticado. O driver deve falhar em todas as chamadas subsequentes que usam esse canal autenticado criado (por exemplo, a função AuthenticatedChannelKeyExchange ) se o dispositivo de exibição especificado nessas chamadas for diferente do dispositivo de exibição que foi usado para criar o canal autenticado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Há suporte para CreateAuthenticatedChannel a partir do sistema operacional Windows 7.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL