Stöd för maskinvarumeddelanden

Gäller för

• Drivrutinsutvecklare och OEM-tillverkare

viktiga API:er

Windows 10 version 1709 tillhandahåller en infrastruktur för maskinvaruagnostiskt stöd för meddelandekomponenter som lysdioder och vibrationsmekanismer. Det här stödet levereras genom införandet av ett kmdf-klasstillägg (Kernel-Mode Driver Framework) specifikt för maskinvaruaviseringskomponenter som möjliggör snabb utveckling av klientdrivrutiner. Ett KMDF-klasstillägg är i huvudsak en KMDF-drivrutin som tillhandahåller en definierad uppsättning funktioner för en viss klass av enheter, ungefär som en portdrivrutin i Windows Driver Model (WDM). Det här avsnittet innehåller en översikt över arkitekturen för maskinvarumeddelandeklasstillägget. Mer information om KMDF finns i Använda WDF för att utveckla en drivrutin.

Maskinvarumeddelandeklasstillägg

Tillägget för maskinvaruaviseringsklassen är den centrala komponenten i arkitekturen för maskinvarumeddelandedrivrutiner. Klasstillägget är utformat för att minimera den nödvändiga interaktionen med KMDF och i stället tillhandahålla ett enkelt gränssnitt för kontroll av meddelandekomponenter. Klasstillägget hanterar uppgifter som:

• Registrering av klientdrivrutiner
• Allokering och rensning av systemresurser
• Registrering av återanropsfunktioner för strömhantering för klientdrivrutiner
• Registrering av I/O-köer för klientdrivrutiner
• Dataverifiering och felkontroll
• Kommunikation av maskinvarubegäranden till klientdrivrutinen

Följande diagram illustrerar den grundläggande arkitekturen för maskinvarumeddelandeklasstillägg.

Klientdrivrutin för maskinvarumeddelanden

Klientdrivrutiner kan enkelt genereras för maskinvaruaviseringskomponenter med hjälp av maskinvarumeddelandeklasstillägget. Klientdrivrutinens enda ansvar är att tillhandahålla lämpliga startpunkter för KMDF, implementera de definierade återanropsfunktionerna för klasstillägg, hantera energitillstånd och kontrollera den fysiska maskinvaran. Mer specifikt måste klientdrivrutinen implementera funktionerna DriverEntry och EVT_WDF_DRIVER_DEVICE_ADD callbackfunktioner för användning av Windows Driver Foundation (WDF) samt nödvändiga callbackfunktioner för klasstillägget.

Följande diagram illustrerar interaktionerna ur klientdrivrutinens perspektiv.