- Programming Drivers for the Kernel Mode Driver Framework
- Sample Drivers by Model
- Sample Drivers by Features
- KMDF Driver Structure and Concepts
- A Minimal KMDF Driver: The Simple Toaster
- Creating a WDF Driver Object: <em>DriverEntry</em>
- Creating the Device Object, Device Interface, and I/O Queue: EvtDriverDeviceAdd
Like this article? We recommend
Like this article? We recommend
Like this article? We recommend
Creating a WDF Driver Object: DriverEntry
Every KMDF driver must have a DriverEntry routine. The DriverEntry routine is the first driver function called when the driver is loaded. The KMDF DriverEntry routine has the same prototype of that of a WDM driver:
NTSTATUS
DriverEntry{
IN PDRIVER_OBJECT DriverObject,
IN PUNICODE_STRING RegistryPath
};
The DriverEntry routine performs the following tasks:
- Creates a driver object (WDFDRIVER), which represents the loaded instance of the driver in memory. In effect, creating this object “registers” the driver with KMDF.
- Registers the driver’s EvtDriverDeviceAdd callback. KMDF calls this function during device enumeration.
- Optionally initializes event tracing for the driver.
- Optionally allocates resources that are required on a driver-wide (rather than per-device) basis.
The following shows the DriverEntry function for the Simple Toaster sample:
NTSTATUS
DriverEntry(
IN PDRIVER_OBJ DriverObject,
IN PUNICODE_STRING RegistryPath
)
{
NTSTATUS status=STATUS_SUCCESS;
WDF_DRIVER_CONFIG config;
KdPrint ((“Toaster Function Driver Sample-“ Driver Framework Edition.\n));
KdPrint ((“Built %s %s\n”, __DATE__, __TIME__));
WDF_DRIVER_CONFIG_INIT(&config, ToasterEvtDeviceAdd);
//
// Create a framework driver object.
//
Status = WdfDriverCreate(
DriverObject,
RegistryPath,
WDF_NO_OBJECT_ATTRIBUTES // Driver Attributes
&config, // Driver Config Info
WDF_NO_HANDLE
);
If ( !INT_SUCCESS(status)) {
KdPrint ((“WdfDriverCreate failed with” “status 0x%x\n”, status));
}
return status;
}
Before creating the WDFDRIVER object, the driver must initialize a driver-object configuration structure (WDF_DRIVER_CONFIG) by using the WDF_DRIVER_CONFIG_INIT function. The function zeroes the structure and then initializes it with a pointer to the driver’s EvtDriverDeviceAdd callback function, which is named ToasterEvtDeviceAdd. KMDF calls this function during device enumeration, when it handles an add-device request that is targeted at the driver.
After setting up the configuration structure, DriverEntry calls WdfDriverCreate to create the WDFDRIVER object, passing as parameters the DriverObject and RegistryPath that were supplied to it, a pointer to the driver object attributes, and a pointer to the filled-in driver configuration structure. The framework’s default attributes are acceptable for the Simple Toaster’s WDFDRIVER object, so the sample specifies WDF_NO_OBJECT_ATTRIBUTES, which KMDF defines as NULL.