FltGetContexts 函式 （fltkernel.h）
FltGetContexts 例程會擷取與目前作業相關物件的迷你篩選驅動程序內容。
語法
VOID FLTAPI FltGetContexts(
PCFLT_RELATED_OBJECTS FltObjects,
FLT_CONTEXT_TYPE DesiredContexts,
PFLT_RELATED_CONTEXTS Contexts
);
參數
FltObjects
[in]FLT_RELATED_OBJECTS 結構的指標，其中包含與目前作業相關的物件不透明指標。 如需此參數的詳細資訊，請參閱一節。
DesiredContexts
[in]識別要擷取的內容類型。 此參數可以是下列值的位 OR。
| 不斷 | 價值 |
|---|---|
| FLT_VOLUME_CONTEXT | 0x0001 |
| FLT_INSTANCE_CONTEXT | 0x0002 |
| FLT_FILE_CONTEXT | 0x0004 |
| FLT_STREAM_CONTEXT | 0x0008 |
| FLT_STREAMHANDLE_CONTEXT | 0x0010 |
| FLT_TRANSACTION_CONTEXT | 0x0020 |
| FLT_SECTION_CONTEXT （從 Windows 8 開始） | 020040 |
| FLT_ALL_CONTEXTS | 所有內容值的位 OR |
Contexts
[out]呼叫端配置的 FLT_RELATED_CONTEXTS 結構的指標，該結構會接收要求的內容。 這是必要參數，而且無法設定為 NULL。 FltMgr 將 結構成員設定為零：
- 呼叫端未要求的內容。
- 呼叫端要求但 FltMgr 找不到的內容。
傳回值
沒有。
言論
如需內容的詳細資訊，請參閱 關於小型篩選內容。
小型篩選驅動程式會呼叫 FltGetContexts，以取 FLT_RELATED_OBJECTS 結構中物件的迷你篩選驅動程式內容指標。
下列迷你篩選驅動程式回呼例程類型會接收 FLT_RELATED_OBJECTS 結構的指標，作為 FltObjects 輸入參數：
- PFLT_PRE_OPERATION_CALLBACK
- PFLT_POST_OPERATION_CALLBACK
- PFLT_INSTANCE_SETUP_CALLBACK
- PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK
- PFLT_INSTANCE_TEARDOWN_CALLBACK
FltGetContexts 遞增 FLT_RELATED_CONTEXTS 結構中所傳回之 Contexts 參數所指向之每個內容的參考計數。 因此，對於每個成功呼叫 FltGetContexts，呼叫端必須：
- 針對 Contexts 參數指向的整個結構呼叫 FltReleaseContexts。
- 針對結構中傳回的每個內容呼叫 FltReleaseContext，並將結構中傳回的每個內容字段設定為零。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 標頭 | fltkernel.h （包括 Fltkernel.h） |
| 連結庫 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
另請參閱
PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK