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

Cria um objeto de canal autenticado. Implementado por um driver de exibição WDDM (Modelo de Driver de Exibição do Windows) 1.2 ou posterior.

Sintaxe

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
  D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
  D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}

Parâmetros

hDevice

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

pCreateData

Um ponteiro para uma estrutura D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL . Essa estrutura especifica os atributos do canal autenticado a ser criado.

hAuthChannel

Um identificador para os dados privados do driver para o objeto de canal autenticado. Para obter mais informações, consulte a seção Comentários.

hRTAuthChannel

Um identificador para o objeto de canal autenticado que o driver deve usar quando ele chama de volta para o runtime do Direct3D.

Retornar valor

Retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	O canal autenticado foi criado com êxito.
D3DDDIERR_DEVICEREMOVED	O adaptador gráfico foi removido.
E_OUTOFMEMORY	A memória não estava disponível para concluir a operação.

Comentários

O runtime do Direct3D chama CreateAuthenticatedChannel(D3D11_1) depois de chamar CalcPrivateAuthenticatedChannelSize do driver para determinar o tamanho em bytes para os dados privados necessários para o objeto de canal autenticado. O runtime aloca a memória para esses dados privados para o driver. O driver usa essa memória para armazenar dados privados relacionados ao objeto de canal de autenticação.

Quando o runtime chama CreateAuthenticatedChannel(D3D11_1), ele passa o identificador para a memória de dados privados no parâmetro hAuthChannel . Esse identificador é, na verdade, um ponteiro para a memória.

O driver deve acompanhar o identificador para o dispositivo de exibição que foi usado para criar o canal autenticado. O driver deve falhar em todas as chamadas subsequentes que usam esse canal autenticado criado, como NegotiateAuthenticatedChannelKeyExchange, se o dispositivo de exibição especificado nessas chamadas for diferente do dispositivo de exibição usado para criar o canal autenticado.

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

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange