BFFDEVICE

Description

The bus filter device object type.

BffDeviceWdmReleaseRemoveLock

  

Description

Release the RemoveLock of the specified BFF device. Call this functioni only in BFF_DISPATCH_PNP or in processing of Irp.

---

Declaration

VOID BffDeviceWdmReleaseRemoveLock(BFFDEVICE BffDevice, PIRP Irp);

---

Parameter

BffDevice	The WDF object as a bus filter device object.
Irp	The PnP I/O request packet.

Return value

None.

BffDeviceWdmAcquireRemoveLock

 

Description

Acquire the RemoveLock of the specified BFF device. Call this function only in BFF_DISPATCH_PNP or in processing of Irp.

---

Declaration

VOID BffDeviceWdmAcquireRemoveLock(BFFDEVICE BffDevice, PIRP Irp);

---

Parameter

BffDevice	The WDF object as a bus filter device object.
Irp	The PnP I/O request packet.

Return value

None.

Is There a Sample Driver?

Yes, you may get it over here. The sample driver, which demonstrates presence of a bus filter by adding a new compatible ID, "BffDevice", to the compatible IDs list, must be installed on Windows 10 or higher, x64.

If you have an old CalDight T3/T4, you may also try the experimental driver, which will add "BffDevice" compatible ID to each of the disks inserted to T3/T4. Thereafter, you may run as administrator asm106x\create_raid_volume.ps1 in PowerShell to create a RAID 5 volume with those disks.

Caution: Make sure you have backed up data in your disks before you run asm106x\create_raid_volume.ps1.

May I Make a Feature Request?

Yes, please fill this form. Please note that not every feature request will be accepted.

How Do I Get the WDM Device Object of a Bus Filter?

BFF provides the following routine for this purpose:

PDEVICE_OBJECT BffDeviceWdmGetDeviceObject(WDFOBJECT BffDevice);

where BffDevice is the WDF general object handle to the bus filter device object.

BffDeviceWdmGetPhysicalDevice

Description

Retrieve the PDO from the device stack of the specified WDF object. Never call this function in EvtDestroyCallback of BffDevice.

---

Declaration

PDEVICE_OBJECT BffDeviceWdmGetPhysicalDevice(BFFDEVICE BffDevice);

---

Parameter

BffDevice

The WDF object as a bus filter device object.

---

Return value

The PDO for success; NULL otherwise.