WdfPreDeviceInstall 函式 （wdfinstaller.h）
[僅適用於 KMDF]
共同安裝程式的 WdfPreDeviceInstall 函式會執行非隨插即用 （PnP） 驅動程式安裝程式建立驅動程式核心模式服務之前，共同安裝程式可能需要的任何作業。
語法
ULONG WdfPreDeviceInstall(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
參數
[in] InfPath
Null 終止之寬字元字串的指標，其中包含驅動程式 INF 檔案的目錄路徑。 驅動程式的安裝程式可以藉由呼叫 getCurrentDirectory 來取得此字串，如 windows SDK Microsoft中所述。
[in, optional] InfSectionName
以 null 結尾的寬字元字串指標，其中包含驅動程式 INF 檔案中 Wdf-install-section 名稱。 如您您需要此名稱的詳細資訊，請參閱使用 KMDF 共同安裝程式 。 如果此指標 NULL，則共同安裝程式會針對名稱使用 WdfSection。
返回值
如果作業成功，WdfPreDeviceInstall 會傳回 ERROR_SUCCESS。 否則，函式會傳回 Winerror.h 中定義的其中一個額外 ERROR_XXX 值。
備註
非 PnP 裝置架構驅動程式的安裝程式必須先呼叫 WdfPreDeviceInstall 或 WdfPreDeviceInstallEx，安裝程式才能 呼叫 createService。
若要取得共同安裝程式 WdfPreDeviceInstall 函式的地址，安裝程式必須在安裝程式呼叫 GetProcAddress 之後呼叫 LoadLibrary 以載入共同安裝程式。
如果共同安裝程式判斷計算機必須重新啟動才能完成驅動程式安裝（通常是因為先前已安裝舊版的架構），WdfPreDeviceInstall 通知即插即用 （PnP） 管理員。 然後，PnP 管理員會提示使用者需要重新啟動。
如需非 PnP 裝置架構驅動程式之 WdfPreDeviceInstall 函式和安裝程式的詳細資訊，請參閱 安裝非 PnP 驅動程式。 如需 CreateService、GetProcAddress和 LoadLibrary的詳細資訊，請參閱 Microsoft Windows SDK 檔。
範例
如需使用 WdfPreDeviceInstall 函式的程式代碼範例，請參閱 NONPNP 範例的安裝程式。
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標題 | wdfinstaller.h （包括 Wdfinstaller.h） |
| 程式庫 | N/A （由 KMDF 共同安裝程式連結庫匯出。如需共同安裝程式連結庫檔名的相關信息，請參閱使用 KMDF 共同安裝程式。） |