共用方式為

WdfPreDeviceInstallEx 函式 (wdfinstaller.h)

  • 發行項

[僅適用於 KMDF]

共同安裝程式的 WdfPreDeviceInstallEx 函式會在非 隨插即用 (PnP) 驅動程式安裝程式建立驅動程式的核心模式服務之前，執行共同安裝程式可能需要的任何作業。

語法

ULONG WdfPreDeviceInstallEx(
  [in]           LPCWSTR                          InfPath,
  [in, optional] LPCWSTR                          InfSectionName,
  [in]           PWDF_COINSTALLER_INSTALL_OPTIONS ClientOptions
);

參數

[in] InfPath

Null 終止寬字元字串的指標，其中包含驅動程式 INF 檔案的目錄路徑。 驅動程式的安裝程式可以藉由呼叫 GetCurrentDirectory 來取得此字串，如 Microsoft Windows SDK 中所述。

[in, optional] InfSectionName

以 Null 結尾的寬字元字串指標，其中包含驅動程式 INF 檔案中的 Wdf-install-section 名稱。 如需此名稱的詳細資訊，請參閱 使用 KMDF 共同安裝程式。 如果此指標為 NULL，則共同安裝程式會使用 WdfSection 進行名稱。

[in] ClientOptions

呼叫端配置的 WDF_COINSTALLER_INSTALL_OPTIONS型別結構的指標，其中包含驅動程式指定的安裝選項。

傳回值

如果作業成功，WdfPreDeviceInstallEx 會傳回ERROR_SUCCESS。 否則，函式會傳回 Winerror.h 中定義的其中一個額外ERROR_XXX 值。

備註

非 PnP 裝置架構驅動程式的安裝程式必須先呼叫 WdfPreDeviceInstall 或 WdfPreDeviceInstallEx ，安裝程式才能呼叫 CreateService。

若要取得共同安裝程式 WdfPreDeviceInstallEx 函式的地址，安裝程式必須在安裝程式呼叫 LoadLibrary 以載入共同安裝程序之後呼叫 GetProcAddress。

如果共同安裝程式判斷計算機必須重新啟動才能完成驅動程式安裝 (通常是因為先前已安裝舊版的架構 ) ，WdfPreDeviceInstallEx 函 式可讓您控制何時或是否提示使用者重新啟動計算機，如下所示：

  • 如果安裝程式將WDF_COINSTALLER_INSTALL_OPTIONS結構的 ShowRebootPrompt 成員設定為 TRUE，WdfPreDeviceInstallEx 會通知 PnP 管理員必須重新啟動電腦，而 PnP 管理員會提示使用者需要重新啟動。 將 ShowRebootPrompt 成員設定為 TRUE 相當於呼叫 WdfPreDeviceInstall。
  • 如果安裝程式將WDF_COINSTALLER_INSTALL_OPTIONS結構的 ShowRebootPrompt 成員設定為 FALSE，WdfPreDeviceInstallEx 不會通知 PnP 管理員需要重新啟動。 相反地，函式會 傳回ERROR_SUCCESS_REBOOT_REQUIRED。 您的安裝程式可以判斷何時或是否要重新啟動電腦。
如需非 PnP 裝置架構驅動程式 WdfPreDeviceInstallEx 函式和安裝程式的詳細資訊，請參閱 安裝非 PnP 驅動程式。 如需 CreateService、GetProcAddress 和 LoadLibrary 的詳細資訊，請參閱 Microsoft Windows SDK 檔。

範例

如需使用 WdfPreDeviceInstallEx 函式的程式碼範例，請參閱 NONPNP 範例的安裝程式。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.9
標頭 wdfinstaller.h (包含 Wdfinstaller.h)
程式庫 KMDF 共同安裝程式連結庫導出的 N/A (。如需共同安裝程式連結庫檔名的相關信息，請參閱使用 KMDF 共同安裝程式.)

另請參閱

WdfPostDeviceInstall

WdfPreDeviceInstall