WdfPreDeviceInstall 函数 (wdfinstaller.h)

  • 项目

[仅适用于 KMDF]

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

语法

ULONG WdfPreDeviceInstall(
  [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 用作名称。

返回值

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

注解

非 PnP 设备的基于框架的驱动程序的安装程序必须先调用 WdfPreDeviceInstall 或 WdfPreDeviceInstallEx ，然后安装程序才能调用 CreateService。

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

如果共同安装程序确定必须重启计算机才能完成驱动程序安装 (通常是因为以前) 安装了较旧版本的框架，则 WdfPreDeviceInstall 会通知即插即用 (PnP) 管理器。 然后，PnP 管理器会提示用户需要重启。

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

示例

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

要求

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

另请参阅

WdfPostDeviceInstall