Installation of WDF Disk Class Filter Driver [KMDF] examples please?

NTDEV
1

I’m hoping you guys can point me in the right direction.

I read through the excellent Filter driver article here, and found the section on installing the WDF filter driver daunting to the say the least…

So, what I did was build a add very similar to the WDFLLRInstall.exe and added code to add entries to the UpperFilters value for the Disk GUID class.

Lo and behold everything works great on Vista. It finds the filter, loads it as a filter device on the disk, (device manager shows as much) and the filter actually works as designed!

My problem happens when I take the exact some process to Windows 7.

On Win7 I go through all the same steps mentioned above, then I see the filter in the “device manager” via Disk Driver Properties, however the driver never actually loads (or if it does load it starts and stops immediately), as I find an entry in the event log indicating the driver could not start either because it is disable or there as no devices associated with it.

Very odd, so I’m wondering, the original article:

http://www.osronline.com/article.cfm?article=446

Is a few years old, is there a new, better, easier, less manual method for installing a KMDF Disk filter driver? Are there some good inf file examples I could learn from? I’ve looked a the KMDF toaster, but there’s a lot of “toaster” stuff going on in there and it’s hard to separate the two.

Suggestions and comments are welcome!

Thanks!

2

I used to use example from toaster to create an upper filter class disk driver. It worked fine but it was WDM driver not WDF.
Did you build your filter as upper class filter. I believe your SOURCE file should have following definition CLASS_UPPER=1. The sample in \WinDDK\7100.0.0\src\general\toaster\kmdf\filter\generic does not specify the type of filter.

Igor Sharovar

3

It might be a version number problem, I believe that the installation
program was written to install KMDF 1.0 so you might need to update the
coinstaller name and KmdfLibraryVersion.

Is a few years old, is there a new, better, easier, less manual method for
installing a KMDF Disk filter driver? Are there some good inf > file
examples I could learn from?

Nope, it’s a manual process. Class filter drivers fall into the “non-PNP”
install category for KMDF, so you have to go through the process of calling
the coinstaller manually. An example in the WDK can be found under
\src\general\ioctl\kmdf\exe.

-scott

–
Scott Noone
Consulting Associate
OSR Open Systems Resources, Inc.
http://www.osronline.com

wrote in message news:xxxxx@ntdev…
> I’m hoping you guys can point me in the right direction.
>
> I read through the excellent Filter driver article here, and found the
> section on installing the WDF filter driver daunting to the say the
> least…
>
> So, what I did was build a add very similar to the WDFLLRInstall.exe and
> added code to add entries to the UpperFilters value for the Disk GUID
> class.
>
> Lo and behold everything works great on Vista. It finds the filter, loads
> it as a filter device on the disk, (device manager shows as much) and the
> filter actually works as designed!
>
> My problem happens when I take the exact some process to Windows 7.
>
> On Win7 I go through all the same steps mentioned above, then I see the
> filter in the “device manager” via Disk Driver Properties, however the
> driver never actually loads (or if it does load it starts and stops
> immediately), as I find an entry in the event log indicating the driver
> could not start either because it is disable or there as no devices
> associated with it.
>
> Very odd, so I’m wondering, the original article:
>
> http://www.osronline.com/article.cfm?article=446
>
> Is a few years old, is there a new, better, easier, less manual method for
> installing a KMDF Disk filter driver? Are there some good inf file
> examples I could learn from? I’ve looked a the KMDF toaster, but there’s a
> lot of “toaster” stuff going on in there and it’s hard to separate the
> two.
>
> Suggestions and comments are welcome!
>
> Thanks!
>
>
>

4

Yes, Scott is correct. The nonpnp sample should show you how to update KMDF in your system.
Also, another small change from the article is that if you want to avoid the reboot prompt that WdfPreDeviceInstall shows you, then you can call WdfPreDeviceInstallEx (http://msdn.microsoft.com/en-us/library/dd835032.aspx) and set ShowRebootPrompt equal to FALSE in the WDF_COINSTALLER_INSTALL_OPTIONS struct. However, keep in mind that if a reboot is required then the callback will return a ERROR_SUCCESS_REBOOT_REQUIRED and you’ll have to reboot your system before your driver gets loaded. This option just allows the calling application to take care of the reboot prompt message (vs having the coinstaller showing the reboot prompt).

Ilias

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Scott Noone
Sent: Tuesday, September 29, 2009 6:46 AM
To: Windows System Software Devs Interest List
Subject: Re:[ntdev] Installation of WDF Disk Class Filter Driver [KMDF] examples please?

It might be a version number problem, I believe that the installation
program was written to install KMDF 1.0 so you might need to update the
coinstaller name and KmdfLibraryVersion.

Is a few years old, is there a new, better, easier, less manual method for
installing a KMDF Disk filter driver? Are there some good inf > file
examples I could learn from?

Nope, it’s a manual process. Class filter drivers fall into the “non-PNP”
install category for KMDF, so you have to go through the process of calling
the coinstaller manually. An example in the WDK can be found under
\src\general\ioctl\kmdf\exe.

-scott

–
Scott Noone
Consulting Associate
OSR Open Systems Resources, Inc.
http://www.osronline.com

wrote in message news:xxxxx@ntdev…
> I’m hoping you guys can point me in the right direction.
>
> I read through the excellent Filter driver article here, and found the
> section on installing the WDF filter driver daunting to the say the
> least…
>
> So, what I did was build a add very similar to the WDFLLRInstall.exe and
> added code to add entries to the UpperFilters value for the Disk GUID
> class.
>
> Lo and behold everything works great on Vista. It finds the filter, loads
> it as a filter device on the disk, (device manager shows as much) and the
> filter actually works as designed!
>
> My problem happens when I take the exact some process to Windows 7.
>
> On Win7 I go through all the same steps mentioned above, then I see the
> filter in the “device manager” via Disk Driver Properties, however the
> driver never actually loads (or if it does load it starts and stops
> immediately), as I find an entry in the event log indicating the driver
> could not start either because it is disable or there as no devices
> associated with it.
>
> Very odd, so I’m wondering, the original article:
>
> http://www.osronline.com/article.cfm?article=446
>
> Is a few years old, is there a new, better, easier, less manual method for
> installing a KMDF Disk filter driver? Are there some good inf file
> examples I could learn from? I’ve looked a the KMDF toaster, but there’s a
> lot of “toaster” stuff going on in there and it’s hard to separate the
> two.
>
> Suggestions and comments are welcome!
>
> Thanks!
>
>
>

—
NTDEV is sponsored by OSR

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer