FilterLoad 函式會動態載入一個 minifilter 驅動程式到系統中。
語法
HRESULT FilterLoad(
[in] LPCWSTR lpFilterName
);
參數
[in] lpFilterName
指標指向一個空終端寬字元字串,該字串指定 minifilter 驅動程式的服務名稱。 此參數為必需,且不能為 NULL 或空字串。
返回值
如果成功,FilterLoad 會回傳S_OK。 否則,會回傳以下其中一種錯誤值:
| 回傳碼 | Description |
|---|---|
|
迷你濾波器驅動程式已經在執行了。 |
|
沒有找到匹配的迷你濾波器驅動程式。 |
|
迷你濾波器驅動程式已經在執行了。 |
|
lpFilterName 指定的 minifilter 驅動程式載入映像檔無效。 |
|
lpFilterName 指定的 minifilter 驅動程式載入映像檔無效。 |
|
迷你濾波器驅動程式的數位簽名無效。 |
備註
FilterLoad 是 Win32 版的 FltLoadFilter。
依賴核心模式迷你濾波器驅動程式的使用者模式應用程式,可以透過呼叫 FilterLoad 來載入該 minifilter 驅動程式。
呼叫 FilterLoad 的使用者必須擁有 SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE 的 LUID)才能載入或卸載 minifilter 驅動程式。 此特權以SE_LOAD_DRIVER_NAME名稱常數命名。 (權限詳見 Microsoft Windows 7 軟體開發套件(SDK)及 .NET Framework 4.0 文件中。)
要卸載 minifilter 驅動程式,請呼叫 FilterUnload。
需求
| Requirement | 價值觀 |
|---|---|
| 目標平臺 | 普遍 |
| Header | fltuser.h(包含 Fltuser.h) |
| Library | 自由圖書館 |
| DLL | FltLib.dll |