WdfPreDeviceRemove function (wdfinstaller.h)

Artikel
02/22/2024

[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.

Syntax

ULONG WdfPreDeviceRemove(
  [in]           LPCWSTR InfPath,
  [in, optional] LPCWSTR InfSectionName
);

Parameters

[in] InfPath

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.

[in, optional] InfSectionName

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.

Remarks

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.

Examples

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

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Header	wdfinstaller.h (include Wdfinstaller.h)
Library	N/A (Exported by the KMDF co-installer library. For information about the co-installer library's filename, see Using the KMDF Co-installer.)

Delen via