WdfPreDeviceRemove 函数 （wdfinstaller.h）

[仅适用于 KMDF]

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

语法

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 设备的基于框架的驱动程序的安装程序必须在安装程序调用 DeleteService之前调用 WdfPreDeviceRemove。

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

有关非 PnP 设备的基于框架的驱动程序的 WdfPreDeviceRemove 功能和安装程序的详细信息，请参阅 安装非 PnP 驱动程序。 有关 DeleteService、GetProcAddress和 LoadLibrary的详细信息，请参阅 Microsoft Windows SDK 文档。

例子

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

要求

另请参阅

WdfPostDeviceRemove