GPIO_CLIENT_DISCONNECT_IO_PINS función de devolución de llamada (gpioclx.h)
La función de devolución de llamada de evento CLIENT_DisconnectIoPins cierra una conexión lógica a un conjunto de patillas de E/S de uso general (GPIO) configuradas para operaciones de lectura o escritura de datos.
Sintaxis
GPIO_CLIENT_DISCONNECT_IO_PINS GpioClientDisconnectIoPins;
NTSTATUS GpioClientDisconnectIoPins(
[in] PVOID Context,
[in] PGPIO_DISCONNECT_IO_PINS_PARAMETERS DisconnectParameters
)
{...}
Parámetros
[in] Context
Puntero al contexto del dispositivo del controlador GPIO.
[in] DisconnectParameters
Puntero a una estructura GPIO_DISCONNECT_IO_PINS_PARAMETERS que describe el conjunto de patillas GPIO que se van a desconectar.
Valor devuelto
La función CLIENT_DisconnectIoPins 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 del marco gpIO (GpioClx) llama a esta función para cerrar una conexión que se abrió previamente mediante una llamada a la función de devolución de llamada CLIENT_ConnectIoPins .
Para registrar la función de devolución de llamada de CLIENT_DisconnectIoPins 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_DisconnectIoPins .
Ejemplos
Para definir un CLIENT_DisconnectIoPins 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 un CLIENT_DisconnectIoPins función de devolución de llamada denominada MyEvtGpioDisconnectIoPins, use el tipo de función GPIO_CLIENT_DISCONNECT_IO_PINS, como se muestra en este ejemplo de código:
GPIO_CLIENT_DISCONNECT_IO_PINS MyEvtGpioDisconnectIoPins;
A continuación, implemente la función de devolución de llamada de la siguiente manera:
_Use_decl_annotations_
NTSTATUS
MyEvtGpioDisconnectIoPins(
PVOID Context,
PGPIO_DISCONNECT_IO_PINS_PARAMETERS DisconnectParameters
)
{ ... }
El tipo de función GPIO_CLIENT_DISCONNECT_IO_PINS 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_DISCONNECT_IO_PINS en el 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 | Se llama en PASSIVE_LEVEL. |