Condividi tramite


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:

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.