Lägga till en enhet

Varning

UMDF 2 är den senaste versionen av UMDF och ersätter UMDF 1. Alla nya UMDF-drivrutiner ska skrivas med UMDF 2. Inga nya funktioner läggs till i UMDF 1 och det finns begränsat stöd för UMDF 1 på nyare versioner av Windows 10. Universella Windows-drivrutiner måste använda UMDF 2.

De arkiverade UMDF 1-exemplen finns i Windows 11 version 22H2 – maj 2022 Uppdatering av drivrutinsexempel.

Mer information finns i Komma igång med UMDF.

Ramverket lägger till ett enhetsobjekt för varje enhet som läses in i värdprocessen för drivrutiner. För att lägga till enheten anropar ramverket drivrutinens IDriverEntry::OnDeviceAdd--metoden och skickar i anropet gränssnitten IWDFDriver- och IWDFDeviceInitialize-. Det angivna IWDFDeviceInitialize-gränssnittet är endast giltigt innan drivrutinen anropar IWDFDriver::CreateDevice. Drivrutinen kan anropa följande metoder i IWDFDeviceInitialize för att utföra dessa åtgärder:

• Drivrutinen anropar metoden IWDFDeviceInitialize::RetrieveDevicePropertyStore för att hämta gränssnittet IWDFNamedPropertyStore för enhetsegenskapssamlingen. Drivrutinen kan använda IWDFNamedPropertyStore för att hämta och ange egenskaper till enheten.

• Drivrutinen anropar metoden IWDFDeviceInitialize::SetLockingConstraint för att ange hur dess återanropsfunktioner anropas av ramverket.

• Drivrutinen anropar metoden IWDFDeviceInitialize::SetFilter för att aktivera enheten som en filterenhet.

När drivrutinen använder IWDFDeviceInitialize för att initiera enheten skickar drivrutinen en pekare till IWDFDeviceInitialisera i ett anrop till metoden IWDFDriver::CreateDevice för att skapa ett UMDF-enhetsobjekt för enheten. När ramverkets enhetsobjekt har skapats anropar drivrutinen IWDFDevice ::CreateIoQueue-metod för att skapa I/O-köer för läsning och skrivning. I dessa IWDFDevice::CreateIoQueue-anrop måste drivrutinen identifiera hur den tar emot begäranden från I/O-kön. Mer information finns i Konfigurera sändningsläge för en I/O-kö.