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)