PFND3DDDI_CREATEAUTHENTICATEDCHANNEL função de retorno de chamada (d3dumddi.h)
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) |