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 裝置架構驅動程式的安裝程式必須先呼叫 WdfPreDeviceRemove ，安裝程式才能呼叫 DeleteService。
若要取得共同安裝程式 WdfPreDeviceRemove 函式的地址，安裝程式必須在安裝程式呼叫 LoadLibrary 以載入共同安裝程序之後呼叫 GetProcAddress。
如需非 PnP 裝置架構驅動程式 WdfPreDeviceRemove 函式和安裝程式的詳細資訊，請參閱 安裝非 PnP 驅動程式。 如需 DeleteService、GetProcAddress 和 LoadLibrary 的詳細資訊，請參閱 Microsoft Windows SDK 檔。
範例
如需使用 WdfPreDeviceRemove 函式的程式碼範例，請參閱 NONPNP 範例的安裝程式。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfinstaller.h (包含 Wdfinstaller.h) |
| 程式庫 | KMDF 共同安裝程式連結庫導出的 N/A (。如需共同安裝程式連結庫檔名的相關信息，請參閱使用 KMDF 共同安裝程式.) |