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 [dentro, fora]
Um ponteiro para uma estrutura de D3DDDIARG_QUERYAUTHENTICATEDCHANNEL que descreve informações de canal autenticado para consulta. Essa estrutura contém um buffer de entrada que descreve a consulta e um buffer de saída para retornar as informações consultadas.
Valor de retorno
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. |
Observações
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 da 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 OPM (Output Protection Manager).
Com exceção das 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 do buffer de entrada e saída não corresponderem aos tamanhos definidos para o GUID especificado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Há suporte para QueryAuthenticatedChannel a partir do sistema operacional Windows 7. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |