Condividi tramite


Creazione di oggetti di callback

Avviso

UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2.

Gli esempi di UMDF 1 archiviati sono disponibili nell'aggiornamento degli esempi di driver di Windows 11 versione 22H2 - Maggio 2022.

Per altre info, vedi Introduzione con UMDF.

Un driver UMDF può creare oggetti di callback, costituiti da dati di contesto e metodi di interfaccia. Il framework accede agli oggetti di callback del driver tramite i metodi di interfaccia di callback del driver.

Nella figura seguente viene illustrato il modo in cui gli oggetti callback implementati dal driver corrispondono agli oggetti framework.

oggetti framework e oggetti callback forniti dal fornitore.

Un driver UMDF può creare diversi tipi di oggetti di callback, tra cui i seguenti:

  • Oggetto callback driver

    Il framework usa l'oggetto callback driver per inizializzare il driver e notificare al driver l'arrivo di un nuovo dispositivo.

  • Oggetto callback del dispositivo

    Il driver usa l'oggetto callback del dispositivo per archiviare il contesto del dispositivo e per gestire la pulizia e la chiusura di oggetti file e eventi di Plug and Play (PnP) e risparmio energia (PM).

  • Oggetto callback della coda

    Il driver usa l'oggetto di callback della coda per elaborare le I/O.

Nella figura seguente viene illustrato come un driver UMDF crea un oggetto callback del dispositivo.

sequenza di chiamata per la creazione di un oggetto callback del dispositivo umdf.

Gli argomenti seguenti contengono esempi di codice che illustrano come creare un oggetto di callback: