共用方式為


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 驅動程式。 如需 DeleteServiceGetProcAddressLoadLibrary 的詳細資訊,請參閱 Microsoft Windows SDK 檔。

範例

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

規格需求

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

另請參閱

WdfPostDeviceRemove