GPIO_CLIENT_DISABLE_INTERRUPT funzione di callback (gpioclx.h)

  • Articolo

La funzione di callback dell'evento CLIENT_DisableInterrupt disabilita gli interruzioni in un pin di I/O (GPIO) per utilizzo generico configurato come input di interruzione.

Sintassi

GPIO_CLIENT_DISABLE_INTERRUPT GpioClientDisableInterrupt;

NTSTATUS GpioClientDisableInterrupt(
  [in] PVOID Context,
  [in] PGPIO_DISABLE_INTERRUPT_PARAMETERS DisableParameters
)
{...}

Parametri

[in] Context

Puntatore al contesto del dispositivo del controller GPIO.

[in] DisableParameters

Puntatore a una struttura GPIO_DISABLE_INTERRUPT_PARAMETERS che descrive il pin di interruzione GPIO.

Valore restituito

La funzione CLIENT_DisableInterrupt 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. GpioClx chiama questa funzione per disabilitare gli interruzioni in un pin GPIO configurato come input della richiesta di interruzione.

Per registrare la funzione di callback del driver CLIENT_DisableInterrupt , 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_DisableInterrupt .

GpioClx chiama sempre le funzioni di CLIENT_EnableInterrupt e CLIENT_DisableInterrupt callback in IRQL = PASSIVE_LEVEL. Tuttavia, se i registri GPIO sono mappati alla memoria, GpioClx chiama le altre funzioni di callback correlate all'interruzione dal relativo ISR in DIRQL. In questo caso, le funzioni CLIENT_EnableInterrupt e CLIENT_DisableInterrupt devono usare il blocco di interruzione GPIO per sincronizzare le operazioni correlate all'interruzione all'ISR. Per altre informazioni, vedere Interruzione della sincronizzazione per i driver del controller GPIO.

Esempio

Per definire una funzione di callback CLIENT_DisableInterrupt , è 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_DisableInterrupt denominata MyEvtGpioDisableInterrupt, usare il tipo di funzione GPIO_CLIENT_DISABLE_INTERRUPT, come illustrato nell'esempio di codice seguente:

GPIO_CLIENT_DISABLE_INTERRUPT MyEvtGpioDisableInterrupt;

Implementare quindi la funzione di callback come indicato di seguito:

_Use_decl_annotations_
VOID
  MyEvtGpioDisableInterrupt(
    PVOID Context,
    PGPIO_DISABLE_INTERRUPT_PARAMETERS DisableParameters
    )
{ ... }

Il tipo di funzione GPIO_CLIENT_DISABLE_INTERRUPT è 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_DISABLE_INTERRUPT 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.

Vedi anche

CLIENT_EnableInterrupt

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_RegisterClient

GPIO_DISABLE_INTERRUPT_PARAMETERS