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) |