GPIO_CLIENT_RECONFIGURE_INTERRUPT funzione di callback (gpioclx.h)
La funzione di callback dell'evento CLIENT_ReconfigureInterrupt riconfigura un pin di I/O per utilizzo generico (GPIO) usato come input di interrupt.
Sintassi
GPIO_CLIENT_RECONFIGURE_INTERRUPT GpioClientReconfigureInterrupt;
NTSTATUS GpioClientReconfigureInterrupt(
[in] PVOID Context,
[in] PGPIO_RECONFIGURE_INTERRUPTS_PARAMETERS ReconfigureParameters
)
{...}
Parametri
[in] Context
Puntatore al contesto di dispositivo del driver del controller GPIO .
[in] ReconfigureParameters
Puntatore a una struttura GPIO_RECONFIGURE_INTERRUPTS_PARAMETERS che specifica come riconfigurare il pin di interrupt GPIO.
Valore restituito
La funzione CLIENT_ReconfigureInterrupt restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Osservazioni:
L'estensione del framework GPIO (GpioClx) potrebbe chiamare la funzione CLIENT_ReconfigureInterrupt per modificare la modalità interrupt o interrompere la polarità di un pin GPIO usato come input di interrupt.
Ad esempio, se l'hardware del controller GPIO non supporta direttamente interrupt attivi-entrambi, ma può essere configurato per supportare interrupt attivi e di basso livello attivo, GpioClx può emulare un pin di interrupt attivo-entrambi chiamando la funzione CLIENT_ReconfigureInterrupt per configurare in alternativa un pin GPIO per gli interrupt in modalità attivo-alto e attivo-basso livello. Per altre informazioni sugli interrupt attivi,vedere la descrizione del flag EmulateActiveBoth in CONTROLLER_ATTRIBUTE_FLAGS.
GpioClx chiama la funzione di callback CLIENT_ReconfigureInterrupt in PASSIVE_LEVEL o DIRQL, a seconda delle informazioni sul dispositivo fornite dalla funzione di callback CLIENT_QueryControllerBasicInformation a GpioClx. La funzione CLIENT_QueryControllerBasicInformation fornisce informazioni sul dispositivo sotto forma di struttura CLIENT_CONTROLLER_BASIC_INFORMATION. Se il bit del flag memoryMappedController è impostato nel membro flag di questa struttura, GpioClx chiama la funzione CLIENT_ReconfigureInterrupt in DIRQL, ovvero l'IRQL in cui viene eseguito l'ISR in GpioClx. In caso contrario, questa funzione viene chiamata in PASSIVE_LEVEL. Per altre informazioni su questo bit di flag, vedere Funzioni di callback GPIO facoltative e obbligatorie.
Esempi
Per definire una funzione di callback CLIENT_ReconfigureInterrupt, è prima necessario fornire 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 di callback consente di
Ad esempio, per definire una funzione di callback CLIENT_ReconfigureInterrupt denominata MyEvtGpioReconfigureInterrupt, usare il tipo di funzione GPIO_CLIENT_RECONFIGURE_INTERRUPT, come illustrato nell'esempio di codice seguente:
GPIO_CLIENT_RECONFIGURE_INTERRUPT MyEvtGpioReconfigureInterrupt;
Implementare quindi la funzione di callback come segue:
_Use_decl_annotations_
NTSTATUS
MyEvtGpioReconfigureInterrupt(
PVOID Context,
PGPIO_RECONFIGURE_INTERRUPTS_PARAMETERS ReconfigureParameters
)
{ ... }
Il tipo di funzione GPIO_CLIENT_RECONFIGURE_INTERRUPT è definito nel file di intestazione Gpioclx.h. Per identificare in modo più accurato gli errori quando si eseguono gli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations assicura che vengano utilizzate le annotazioni applicate al tipo di funzione GPIO_CLIENT_RECONFIGURE_INTERRUPT nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite i tipi di ruolo della funzione per i driver KMDF. Per altre informazioni su Use_decl_annotations, vedere l'annotazione del comportamento della funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 8. |
| Piattaforma di destinazione | Schermo |
| intestazione | gpioclx.h |
| IRQL | Vedere la sezione Osservazioni. |
Vedere anche
CLIENT_CONTROLLER_BASIC_INFORMATION