PFND3DDDI_QUERYAUTHENTICATEDCHANNEL função de retorno de chamada (d3dumddi.h)
A função QueryAuthenticatedChannel consulta um canal autenticado para obter informações de capacidade e estado.
Sintaxe
PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;
HRESULT Pfnd3dddiQueryauthenticatedchannel(
HANDLE hDevice,
const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *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_QUERYAUTHENTICATEDCHANNEL que descreve informações de canal autenticado a serem consultadas. Essa estrutura contém um buffer de entrada que descreve a consulta e um buffer de saída para retornar as informações consultadas.
Retornar valor
QueryAuthenticatedChannel retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | O canal autenticado é consultado com êxito. |
| E_OUTOFMEMORY | QueryAuthenticatedChannel não pôde alocar a memória necessária para que ela fosse concluída. |
Comentários
O buffer de entrada contém o identificador do driver para o canal autenticado, um número de sequência e um GUID que indica o tipo de consulta. O driver deverá falhar em todas as consultas se o driver não tiver inicializado anteriormente o número de sequência por meio de uma chamada para sua função ConfigureAuthenticatedChannel . O driver também deverá falhar na consulta se o número de sequência não for maior que o número de sequência da chamada de consulta anterior.
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 do OPM ( Output Protection Manager ).
Exceto para as 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.
QueryAuthenticatedChannel executa operações diferentes dependendo de cada um dos GUIDs a seguir especificados na estrutura de entrada. O driver deverá falhar se os tamanhos de buffer de entrada e saída não corresponderem aos tamanhos definidos para o GUID especificado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Há suporte para QueryAuthenticatedChannel a partir do sistema operacional Windows 7. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |