Notifiche hardware

Windows offre un'infrastruttura per il supporto hardware-agnostico dei componenti di notifica, ad esempio i LED e i meccanismi di vibrazione. Questo supporto viene fornito tramite l'introduzione di un'estensione di 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 fornisce una panoramica dell'architettura dell'estensione della classe di notifica hardware.

Per altre informazioni sul servizio di gestione delle chiavi, vedere Uso di WDF per sviluppare un driver.

Per fornire supporto per le notifiche hardware, è necessario:

• hwnclx.h

Enumerazioni

HWN_CLX_EXPORT_INDEX Definisce la posizione per ognuna delle esportazioni di notifica hardware nella tabella di esportazione.

Funzioni

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 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 dei componenti 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 non inizializza il componente di notifica hardware.
HwNProcessAddDevicePostDeviceCreate Crea code di I/O. Deve essere chiamato dopo che la funzione di callback del driver client EVT_WDF_DRIVER_DEVICE_ADD viene richiamata e l'oggetto dispositivo è stato creato.
HwNProcessAddDevicePreDeviceCreate Fornisce i callback di preparazione/rilascio e rilascio 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 le relative funzioni di callback con l'estensione della classe. Questa funzione deve essere richiamata quando il driver client viene scaricato.

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.