Intestazione hwnclx.h
Questa intestazione definisce le interfacce di programmazione necessarie per fornire supporto indipendente dall'hardware di componenti di notifica, ad esempio LED e meccanismi di vibrazione. Questo supporto viene fornito tramite l'introduzione di un'estensione della classe Kernel-Mode Driver Framework (KMDF) specificamente per i componenti di notifica hardware che consentono lo sviluppo rapido dei driver client. Un'estensione della classe KMDF è essenzialmente un driver KMDF che fornisce un set definito di funzionalità per una determinata classe di dispositivi, simile a un driver di porta nel modello di driver Windows (WDM). Questa sezione offre una panoramica dell'architettura dell'estensione della classe di notifica hardware. Per altre informazioni su KMDF, vedere
Per altre informazioni, vedere:
hwnclx.h contiene le interfacce di programmazione seguenti:
Funzioni
|
HwNProcessAddDevicePostDeviceCreate Crea code di I/O. Deve essere chiamato dopo che viene richiamata la funzione di callback del driver client EVT_WDF_DRIVER_DEVICE_ADD e l'oggetto dispositivo è stato creato. |
|
HwNProcessAddDevicePreDeviceCreate Fornisce i callback di preparazione/rilascio e uscita del dispositivo a Windows Driver Foundation (WDF) per la transizione del dispositivo in stati diversi. |
|
HwNRegisterClient Registra il driver client di notifica hardware e le relative funzioni di callback con l'estensione della classe. |
|
HwNUnregisterClient Annulla la registrazione del driver client di notifica hardware e delle relative funzioni di callback con l'estensione della classe. Questa funzione deve essere richiamata quando il driver client viene scaricato. |
Funzioni di callback
|
HWN_CLIENT_GET_STATE Implementato dal driver client per ottenere lo stato del componente di notifica hardware. Viene richiamato quando un utente richiede informazioni sullo stato. |
|
HWN_CLIENT_INITIALIZE_DEVICE Implementato dal driver client e viene richiamato come risultato di una chiamata a EVT_WDF_DEVICE_PREPARE_HARDWARE. |
|
HWN_CLIENT_QUERY_DEVICE_INFORMATION Implementato dal driver client per recuperare gli attributi del componente di notifica hardware. |
|
HWN_CLIENT_SET_STATE Implementato dal driver client per impostare lo stato del componente di notifica hardware. Viene richiamato quando un utente vuole modificare lo stato di un driver. |
|
HWN_CLIENT_START_DEVICE Implementato dal driver client per avviare il componente di notifica hardware. Viene richiamato come risultato di una chiamata a EVT_WDF_DEVICE_D0_ENTRY. |
|
HWN_CLIENT_STOP_DEVICE Implementato dal driver client PER avviare il componente di notifica hardware. Viene richiamato come risultato di una chiamata a EVT_WDF_DEVICE_D0_EXIT. |
|
HWN_CLIENT_UNINITIALIZE_DEVICE Implementato dal driver client e richiamato come richiamato come risultato di una chiamata a EVT_WDF_DEVICE_RELEASE_HARDWARE. Questa funzione di callback annulla l'inizializzazione del componente di notifica hardware. |
Strutture
|
CLIENT_DEVICE_INFORMATION La struttura CLIENT_DEVICE_INFORMATION viene usata dal callback di notifica hardware HWN_CLIENT_QUERY_DEVICE_INFORMATION per restituire il numero totale di notifiche hardware fornite dal driver del dispositivo client. |
|
HWN_CLIENT_REGISTRATION_PACKET Pacchetto di registrazione del driver client di notifica hardware passato all'estensione della classe quando viene registrato un driver client. Contiene informazioni sulla versione e funzioni di callback del driver client. |
Enumerazioni
|
HWN_CLX_EXPORT_INDEX Definisce la posizione per ognuna delle esportazioni di notifica hardware nella tabella di esportazione. |