WdfPreDeviceRemove 函数 (wdfinstaller.h)

[仅适用于 KMDF]

在非即插即用 (PnP) 驱动程序的安装程序删除驱动程序的内核模式服务之前,共同安装程序的 WdfPreDeviceRemove 函数执行共同安装程序可能需要的任何操作。

语法

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

参数

[in] InfPath

指向以 null 结尾的宽字符字符串的指针,该字符串包含驱动程序 INF 文件的目录路径。 驱动程序的安装程序可以通过调用 getCurrentDirectory 来获取此字符串,如Microsoft Windows SDK中所述。

[in, optional] InfSectionName

指向以 null 结尾的宽字符字符串的指针,该字符串包含驱动程序 INF 文件中的 Wdf-install-section 名称。 有关此名称的详细信息,请参阅 使用 KMDF 共同安装程序。 如果此指针为 NULL,则辅助安装程序将 WdfSection 用作名称。

返回值

如果操作成功,WdfPreDeviceRemove 将返回ERROR_SUCCESS。 否则,该函数返回 Winerror.h 中定义的附加 ERROR_XXX 值之一。

注解

非 PnP 设备的基于框架的驱动程序的安装程序必须先调用 WdfPreDeviceRemove ,然后安装程序才能调用 DeleteService

若要获取共同安装程序的 WdfPreDeviceRemove 函数的地址,安装程序必须在安装程序调用 LoadLibrary 以加载辅助安装程序后调用 GetProcAddress

有关非 PnP 设备的基于框架的驱动程序的 WdfPreDeviceRemove 函数和安装程序的详细信息,请参阅 安装非 PnP 驱动程序。 有关 DeleteServiceGetProcAddressLoadLibrary 的详细信息,请参阅Microsoft Windows SDK文档。

示例

有关使用 WdfPreDeviceRemove 函数的代码示例,请参阅 NONPNP 示例的安装程序。

要求

要求
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfinstaller.h (包括 Wdfinstaller.h)
Library KMDF 共同安装程序库导出的 N/A (。有关共同安装程序库的文件名的信息,请参阅使用 KMDF Co-installer.)

另请参阅

WdfPostDeviceRemove