GPIO_CLIENT_QUERY_ACTIVE_INTERRUPTS función de devolución de llamada (gpioclx.h)

Artículo
08/07/2023

La función de devolución de llamada de evento CLIENT_QueryActiveInterrupts consulta el estado de un conjunto de patillas de E/S de uso general (GPIO) configuradas como entradas de interrupción.

Sintaxis

GPIO_CLIENT_QUERY_ACTIVE_INTERRUPTS GpioClientQueryActiveInterrupts;

NTSTATUS GpioClientQueryActiveInterrupts(
  [in]      PVOID Context,
  [in, out] PGPIO_QUERY_ACTIVE_INTERRUPTS_PARAMETERS QueryActiveParameters
)
{...}

Parámetros

[in] Context

Puntero al contexto del dispositivo del controlador GPIO.

[in, out] QueryActiveParameters

Puntero a una estructura de GPIO_QUERY_ACTIVE_INTERRUPTS_PARAMETERS que, en la entrada, describe las patillas de interrupción gpIO para consultar y, al salir, contiene el estado de interrupción activo y habilitado de estas patillas.

Valor devuelto

La función CLIENT_QueryActiveInterrupts devuelve STATUS_SUCCESS si la llamada se realiza correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

El controlador del controlador GPIO implementa esta función de devolución de llamada. La extensión de marco gpIO (GpioClx) llama a esta función para consultar un conjunto de patillas GPIO configuradas como entradas de solicitud de interrupción.

El parámetro QueryActiveParameters apunta a una estructura de GPIO_QUERY_ACTIVE_INTERRUPTS_PARAMETERS asignada por el autor de la llamada. El llamador establece los valores de los miembros BankId y EnabledMask de esta estructura. La función CLIENT_QueryActiveInterrupts escribe en el miembro ActiveMask de la estructura.

En la entrada, los bits establecidos en el miembro EnabledMask deben coincidir con el conjunto de interrupciones habilitadas actualmente en el banco. A cambio, los bits establecidos en el miembro ActiveMask deben corresponder a interrupciones que están habilitadas y activas. Por lo tanto, si un bit en EnabledMask es cero, el bit correspondiente en ActiveMask debe ser cero.

Para registrar la CLIENT_QueryActiveInterrupts función de devolución de llamada del controlador, llame al método GPIO_CLX_RegisterClient . Este método acepta, como parámetro de entrada, un puntero a una estructura de GPIO_CLIENT_REGISTRATION_PACKET que contiene un puntero de función CLIENT_QueryActiveInterrupts .

GpioClx llama a la función de devolución de llamada CLIENT_QueryActiveInterrupts en PASSIVE_LEVEL o DIRQL, en función de la información del dispositivo que la función de devolución de llamada CLIENT_QueryControllerBasicInformation proporciona a GpioClx. La función CLIENT_QueryControllerBasicInformation proporciona información del dispositivo en forma de estructura CLIENT_CONTROLLER_BASIC_INFORMATION . Si el bit de marca MemoryMappedController se establece en el miembro Flags de esta estructura, GpioClx llama a la función CLIENT_QueryActiveInterrupts en DIRQL, que es el IRQL en el que se ejecuta el ISR en GpioClx. De lo contrario, se llama a esta función en PASSIVE_LEVEL. Para obtener más información sobre este bit de marca, vea Funciones de devolución de llamada GPIO opcionales y obligatorias.

Ejemplos

Para definir un CLIENT_QueryActiveInterrupts función de devolución de llamada, primero debe proporcionar una declaración de función que identifique el tipo de función de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Análisis de código para controladores, Comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una función de devolución de llamada CLIENT_QueryActiveInterrupts denominada MyEvtGpioQueryActiveInterrupts, use el tipo de función GPIO_CLIENT_QUERY_ACTIVE_INTERRUPTS, como se muestra en este ejemplo de código:

GPIO_CLIENT_QUERY_ACTIVE_INTERRUPTS MyEvtGpioQueryActiveInterrupts;

A continuación, implemente la función de devolución de llamada de la siguiente manera:

_Use_decl_annotations_
NTSTATUS
  MyEvtGpioQueryActiveInterrupts(
    PVOID Context,
    PGPIO_QUERY_ACTIVE_INTERRUPTS_PARAMETERS QueryActiveParameters
    )
{ ... }

El tipo de función GPIO_CLIENT_QUERY_ACTIVE_INTERRUPTS se define en el archivo de encabezado Gpioclx.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función GPIO_CLIENT_QUERY_ACTIVE_INTERRUPTS del archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante tipos de rol de función para controladores KMDF. Para obtener más información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite a partir de Windows 8.
Plataforma de destino	Escritorio
Encabezado	gpioclx.h
IRQL	Vea la sección Comentarios.