PFND3DDDI_QUERYAUTHENTICATEDCHANNEL función de devolución de llamada (d3dumddi.h)

La función QueryAuthenticatedChannel consulta un canal autenticado para obtener información de estado y funcionalidad.

Sintaxis

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pData [in, out]

Puntero a una estructura de D3DDDIARG_QUERYAUTHENTICATEDCHANNEL que describe la información del canal autenticado que se va a consultar. Esta estructura contiene un búfer de entrada que describe la consulta y un búfer de salida para devolver la información consultada.

Valor devuelto

QueryAuthenticatedChannel devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	El canal autenticado se consulta correctamente.
E_OUTOFMEMORY	QueryAuthenticatedChannel no pudo asignar la memoria necesaria para que se complete.

Comentarios

El búfer de entrada contiene el identificador del controlador para el canal autenticado, un número de secuencia y un GUID que indica el tipo de consulta. El controlador debe producir un error en todas las consultas si el controlador no inicializó previamente el número de secuencia a través de una llamada a su función ConfigureAuthenticatedChannel . El controlador también debe producir un error en la consulta si el número de secuencia no es mayor que el número de secuencia de la llamada de consulta anterior.

El controlador debe duplicar los datos de entrada en la estructura del búfer de salida y debe firmar la estructura de salida de forma idéntica a cómo controla actualmente las consultas del Administrador de protección de salida (OPM).

Excepto en aquellas situaciones en las que la aplicación especifica incorrectamente un búfer de salida demasiado pequeño, el controlador siempre debe colocar el código de retorno en la estructura de salida. Por lo tanto, la aplicación tiene un mecanismo seguro para determinar el código de retorno.

QueryAuthenticatedChannel realiza diferentes operaciones en función de cada uno de los GUID siguientes que se especifican en la estructura de entrada. El controlador debe producir un error si los tamaños del búfer de entrada y salida no coinciden con los tamaños definidos para el GUID especificado.

Requisitos

Requisito	Value
Cliente mínimo compatible	QueryAuthenticatedChannel se admite a partir del sistema operativo Windows 7.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL