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 驱动程序。 有关 DeleteService、GetProcAddress 和 LoadLibrary 的详细信息,请参阅Microsoft Windows SDK文档。
示例
有关使用 WdfPreDeviceRemove 函数的代码示例,请参阅 NONPNP 示例的安装程序。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfinstaller.h (包括 Wdfinstaller.h) |
Library | KMDF 共同安装程序库导出的 N/A (。有关共同安装程序库的文件名的信息,请参阅使用 KMDF Co-installer.) |