FilterInstanceCreate 函式 (fltuser.h)
FilterInstanceCreate 函式會建立句柄，可用來與指定的迷你篩選實例通訊。
語法
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
參數
[in] lpFilterName
Null 終止寬字元字串的指標，其中包含擁有實例之迷你篩選器的名稱。
[in] lpVolumeName
以 Null 結尾的寬字元字串指標，其中包含實例所附加的磁碟區名稱。
lpVolumeName 輸入字串可以是下列任一項。 尾端反斜杠 (\) 是選擇性的。
- 驅動器號，例如 “D：\”
- 磁碟區裝入點的路徑，例如 “c：\mnt\edrive\”
- 唯一磁碟區標識碼 (也稱為磁碟區 GUID 名稱) ，例如 “\？？\Volume{7603f260-142a-11d4-ac67-806d6172696f}\”
- 非持續性裝置名稱 (也稱為 目標名稱 或 NT 裝置名稱) ，例如 “\Device\HarddiskVolume1\”
[in, optional] lpInstanceName
以 Null 結尾的寬字元字串指標，其中包含實例的實例名稱。 此參數是選擇性的，可以是 NULL。 如果是 NULL，則會傳回此磁碟區上找到此迷你篩選器的第一個實例。
[out] hInstance
如果呼叫 FilterInstanceCreate 成功，則會接收迷你篩選實例不透明句柄的呼叫端配置變數指標;否則，它會收到INVALID_HANDLE_VALUE。
傳回值
FilterInstanceCreate 如果成功，則會傳回S_OK。 否則，它會傳回錯誤值。
備註
使用者模式應用程式會呼叫 FilterInstanceCreate ，以建立可用來與內核模式迷你篩選實例通訊的句柄。 傳回的實例句柄可以當做參數傳遞至 FilterInstanceGetInformation 等函式。
若要關閉 FilterInstanceCreate 傳回的實例句柄，請呼叫 FilterInstanceClose。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | fltuser.h (包含 Fltuser.h) |
| 程式庫 | FltLib.lib |
| Dll | FltLib.dll |