Framework-apparaatobjekt

Waarschuwing

UMDF 2 is de nieuwste versie van UMDF en vervangt UMDF 1. Alle nieuwe UMDF-stuurprogramma's moeten worden geschreven met UMDF 2. Er worden geen nieuwe functies toegevoegd aan UMDF 1 en er is beperkte ondersteuning voor UMDF 1 op nieuwere versies van Windows 10. Universele Windows-stuurprogramma's moeten UMDF 2 gebruiken.

De gearchiveerde UMDF 1-voorbeelden vindt u in de Windows 11 versie 22H2 - update van stuurprogrammavoorbeelden van mei 2022.

Zie Aan de slag met UMDF-voor meer informatie.

Het framework-apparaatobject wordt blootgesteld aan stuurprogramma's door de IWDFDevice-interface . Het frameworkapparaatobject is de frameworkweergave van het apparaat op het systeem. Elk apparaatobject heeft een ouder stuurprogrammaobject.

Wanneer een nieuw apparaat binnenkomt in het systeem, roept het framework de methode IDriverEntry::OnDeviceAdd aan om het stuurprogramma van de aankomst op de hoogte te stellen en de IWDFDriver - en IWDFDeviceInitialize-interfaces in de aanroep door te geven. Het stuurprogramma kan methoden van de IWDFDeviceInitialize-interface aanroepen om het nieuwe apparaat te initialiseren. Het stuurprogramma roept bijvoorbeeld de methode IWDFDeviceInitialize::RetrieveDevicePropertyStore aan om te zoeken naar de apparaatgegevens die zijn opgegeven als onderdeel van de installatie van het apparaat. Het stuurprogramma kan vervolgens de methode IWDFDriver::CreateDevice aanroepen om het apparaatobject te configureren en te maken.

Wanneer stuurprogramma's een frameworkapparaatobject maken, kunnen zij hun interfaces IPnpCallback, IPnpCallbackSelfManagedIo, IPnpCallbackHardware, IFileCallbackCleanup en IFileCallbackClose registreren. Het framework meldt vervolgens het stuurprogramma wanneer bestanden worden opgeschoond en gesloten en PnP-gebeurtenissen (Plug and Play) en energiebeheer (PM) plaatsvinden. Zie PnP en Power Management in UMDF-stuurprogramma's voor meer informatie over het ondersteunen van PnP en PM.