GPIO_CLIENT_DISCONNECT_IO_PINS funzione di callback (gpioclx.h)

Articolo
02/29/2024

La funzione di callback eventi CLIENT_DisconnectIoPins chiude una connessione logica a un set di pin di I/O (GPIO) per utilizzo generico configurati per le operazioni di lettura o scrittura dei dati.

Sintassi

GPIO_CLIENT_DISCONNECT_IO_PINS GpioClientDisconnectIoPins;

NTSTATUS GpioClientDisconnectIoPins(
  [in] PVOID Context,
  [in] PGPIO_DISCONNECT_IO_PINS_PARAMETERS DisconnectParameters
)
{...}

Parametri

[in] Context

Puntatore al contesto del dispositivo del controller GPIO.

[in] DisconnectParameters

Puntatore a una struttura GPIO_DISCONNECT_IO_PINS_PARAMETERS che descrive il set di pin GPIO da disconnettere.

Valore restituito

La funzione CLIENT_DisconnectIoPins restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

Questa funzione di callback viene implementata dal driver del controller GPIO. L'estensione del framework GPIO (GpioClx) chiama questa funzione per chiudere una connessione aperta in precedenza da una chiamata alla funzione di callback CLIENT_ConnectIoPins.

Per registrare la funzione di callback del driver CLIENT_DisconnectIoPins , chiamare il metodo GPIO_CLX_RegisterClient . Questo metodo accetta, come parametro di input, un puntatore a una struttura GPIO_CLIENT_REGISTRATION_PACKET che contiene un puntatore alla funzione CLIENT_DisconnectIoPins .

Esempio

Per definire una funzione di callback CLIENT_DisconnectIoPins , è prima necessario specificare una dichiarazione di funzione che identifica il tipo di funzione di callback che si sta definendo. Windows fornisce un set di tipi di funzione di callback per i driver. La dichiarazione di una funzione usando i tipi di funzione callback consente l'analisi del codice per i driver, il verifica driver statico (SDV) e altri strumenti di verifica trovano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una funzione di callback CLIENT_DisconnectIoPins denominata MyEvtGpioDisconnectIoPins, usare il tipo di funzione GPIO_CLIENT_DISCONNECT_IO_PINS, come illustrato nell'esempio di codice seguente:

GPIO_CLIENT_DISCONNECT_IO_PINS MyEvtGpioDisconnectIoPins;

Implementare quindi la funzione di callback come indicato di seguito:

_Use_decl_annotations_
NTSTATUS
  MyEvtGpioDisconnectIoPins(
    PVOID Context,
    PGPIO_DISCONNECT_IO_PINS_PARAMETERS DisconnectParameters
    )
{ ... }

Il tipo di funzione GPIO_CLIENT_DISCONNECT_IO_PINS è definito nel file di intestazione Gpioclx.h. Per identificare in modo più accurato gli errori durante l'esecuzione degli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations garantisce che vengano usate le annotazioni applicate al tipo di funzione GPIO_CLIENT_DISCONNECT_IO_PINS nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver KMDF. Per altre informazioni su Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato a partire da Windows 8.
Piattaforma di destinazione	Desktop
Intestazione	gpioclx.h
IRQL	Chiamato in PASSIVE_LEVEL.