WdfPreDeviceRemove 函式 (wdfinstaller.h)
[僅適用於 KMDF]
共同安裝程式的 WdfPreDeviceRemove 函式會執行非隨插即用 (PnP) 驅動程式安裝程式刪除驅動程式核心模式服務之前,共同安裝程式可能需要的任何作業。
語法
ULONG WdfPreDeviceRemove(
[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。
返回值
如果作業成功,WdfPreDeviceRemove 會傳回 ERROR_SUCCESS。 否則,函式會傳回 Winerror.h 中定義的其中一個額外 ERROR_XXX 值。
備註
非 PnP 裝置架構驅動程式的安裝程式必須先呼叫 WdfPreDeviceRemove,安裝程式才能呼叫 deleteService 。
若要取得共同安裝程式 WdfPreDeviceRemove 函式的位址,安裝程式必須在安裝程式呼叫 GetProcAddress,安裝程式呼叫 LoadLibrary 以載入共同安裝程式。
如需非 PnP 裝置架構驅動程式之 WdfPreDeviceRemove 函式和安裝程式的詳細資訊,請參閱 安裝非 PnP 驅動程式。 如需 DeleteService、GetProcAddress和 LoadLibrary的詳細資訊,請參閱 Microsoft Windows SDK 檔。
範例
如需使用 WdfPreDeviceRemove 函式的程式代碼範例,請參閱 NONPNP 範例的安裝程式。
需求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
標題 | wdfinstaller.h (包括 Wdfinstaller.h) |
程式庫 | N/A (由 KMDF 共同安裝程式連結庫匯出。如需共同安裝程式連結庫檔名的相關信息,請參閱使用 KMDF 共同安裝程式。) |