FltGetFilterFromInstance 函式 (fltkernel.h)
FltGetFilterFromInstance 例程會針對建立指定實例的迷你篩選驅動程式傳回不透明的篩選指標。
語法
NTSTATUS FLTAPI FltGetFilterFromInstance(
[in] PFLT_INSTANCE Instance,
[out] PFLT_FILTER *RetFilter
);
參數
[in] Instance
實例的不透明實例指標。
[out] RetFilter
呼叫端配置的變數指標,該變數會接收迷你篩選驅動程式的不透明篩選指標。 這是必要參數,而且無法 NULL。
傳回值
FltGetFilterFromInstance 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值,如下所示:
傳回碼 | 描述 |
---|---|
|
小型篩選驅動程式正在被拆毀。 這是錯誤碼。 |
言論
FltGetFilterFromInstance 會將 rundown 參考新增至 RetFilter 參數中傳回的不透明篩選指標。 不再需要此指標時,呼叫端必須呼叫 FltObjectDereference來釋放它。 因此,FltGetFilterFromInstance 的每個成功呼叫,都必須比對 FltObjectDereference 的後續呼叫。
若要取得附加指定迷你篩選驅動程序實例之磁碟區的不透明磁碟區指標,請呼叫 FltGetVolumeFromInstance。
若要列舉指定迷你篩選驅動程式的所有實例,請呼叫 FltEnumerateInstanceInformationByFilter。
若要列舉所有磁碟區上所有小型篩選驅動程式的實例,請呼叫 fltEnumerateInstances 。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | fltkernel.h (包括 Fltkernel.h) |
連結庫 | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |