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:

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

Confira também

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL