共用方式為


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

範例

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

需求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標題 wdfinstaller.h (包括 Wdfinstaller.h)
程式庫 N/A (由 KMDF 共同安裝程式連結庫匯出。如需共同安裝程式連結庫檔名的相關信息,請參閱使用 KMDF 共同安裝程式。)

另請參閱

WdfPostDeviceRemove