WdfPreDeviceRemove function

[Applies to KMDF only]

The co-installer's WdfPreDeviceRemove function performs any operations that the co-installer might require before a non-Plug and Play (PnP) driver's installer deletes the driver's kernel-mode service.


ULONG WdfPreDeviceRemove(
  _In_     LPCWSTR InfPath,
  _In_opt_ LPCWSTR InfSectionName


InfPath [in]

A pointer to a null-terminated wide-character string that contains the directory path to the driver's INF file. The driver's installer can obtain this string by calling GetCurrentDirectory, which is described in the Microsoft Windows SDK.

InfSectionName [in, optional]

A pointer to a null-terminated wide-character string that contains the Wdf-install-section name in the driver's INF file. For more information about this name, see Using the KMDF Co-installer. If this pointer is NULL, the co-installer uses WdfSection for the name.

Return value

WdfPreDeviceRemove returns ERROR_SUCCESS if the operation succeeds. Otherwise, the function returns one of the additional ERROR_XXX values that are defined in Winerror.h.


The installer for the framework-based drivers of a non-PnP device must call WdfPreDeviceRemove before the installer calls DeleteService.

To obtain the address of the co-installer's WdfPreDeviceRemove function, the installer must call GetProcAddress after the installer has called LoadLibrary to load the co-installer.

For more information about the WdfPreDeviceRemove function and installers for framework-based drivers of non-PnP devices, see Installing a Non-PnP Driver. For more information about DeleteService, GetProcAddress, and LoadLibrary, see the Microsoft Windows SDK documentation.


For a code example that uses the WdfPreDeviceRemove function, see the installer for the NONPNP sample.


Target platform


Minimum KMDF version



Wdfinstaller.h (include Wdfinstaller.h)


N/A (Exported by the KMDF co-installer library. For information about the co-installer library's filename, see Using the KMDF Co-installer.)

See also




Send comments about this topic to Microsoft