共用方式為


FLT_RELATED_OBJECTS 結構 (fltkernel.h)

FLT_RELATED_OBJECTS 結構包含與作業相關聯之物件的不透明指標。

語法

typedef struct _FLT_RELATED_OBJECTS {
  USHORT        Size;
  USHORT        TransactionContext;
  PFLT_FILTER   Filter;
  PFLT_VOLUME   Volume;
  PFLT_INSTANCE Instance;
  PFILE_OBJECT  FileObject;
  PKTRANSACTION Transaction;
} FLT_RELATED_OBJECTS, *PFLT_RELATED_OBJECTS;

成員

Size

FLT_RELATED_OBJECTS 結構的大小,以位元組為單位。

TransactionContext

如果 Transaction 成員不是 NULL,則包含交易迷你版本標識碼值的不透明成員。 如果 TransactionNULL則 TransactionContext 的值未定義。

Filter

迷你篩選驅動程式的不透明篩選指標,其回呼例程正在針對作業呼叫。 只要載入迷你篩選驅動程式,此指標就會唯一識別迷你篩選驅動程式,並維持不變。

Volume

與作業相關聯之磁碟區的不透明磁碟區指標。 此指標可唯一識別磁碟區,並在磁碟區裝置堆疊的存留期內維持不變。

Instance

與作業相關聯的迷你篩選驅動程序實例不透明實例指標。 只要實例附加至磁碟區,此指標就會唯一識別實例,並維持不變。

FileObject

如果有任何,則為作業的檔案對象指標。

Transaction

在 Windows Vista 和更新版本上,此成員是與作業相關聯的交易不透明交易指標。 如果這個成員的值不是 NULL,作業將會是交易的一部分。 如果這個成員的值是 NULL,作業將不會是交易的一部分。 在 Windows Vista 之前的 Windows 作業系統上,此成員的值一律為 NULL

備註

FLT_RELATED_OBJECTS 結構是由篩選管理員所配置,並包含與 I/O 作業或實例設定或卸除作業相關聯之物件的不透明指標。

篩選管理員會設定FLT_RELATED_OBJECTS結構的內容。 迷你篩選驅動程式無法直接修改此結構的內容。 不過,如果迷你篩選驅動程式修改作業 FLT_IO_PARAMETER_BLOCK 結構中 I/O 作業的目標實例或目標檔案物件,篩選管理員會修改傳遞至較低迷你篩選器驅動程式之FLT_RELATED_OBJECTS結構之對應 InstanceFileObject 成員的值。 如需詳細資訊,請參閱 修改 I/O 作業的參數

迷你篩選驅動程式會接收FLT_RELATED_OBJECTS結構的指標,做為下列回呼例程類型的 FltObjects 輸入參數:

PFLT_POST_OPERATION_CALLBACK

PFLT_PRE_OPERATION_CALLBACK

PFLT_INSTANCE_SETUP_CALLBACK

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK

PFLT_INSTANCE_TEARDOWN_CALLBACK

若要擷取FLT_RELATED_OBJECTS結構中物件的迷你篩選驅動程序內容的指標,請呼叫 FltGetContexts

注意typedef CONST struct _FLT_RELATED_OBJECTS *PCFLT_RELATED_OBJECTS;
 

規格需求

需求
標頭 fltkernel.h (包含 Fltkernel.h)

另請參閱

FLT_IO_PARAMETER_BLOCK

FLT_RELATED_CONTEXTS

FltDoCompletionProcessingWhenSafe

FltGetContexts

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK

PFLT_INSTANCE_SETUP_CALLBACK

PFLT_INSTANCE_TEARDOWN_CALLBACK

PFLT_POST_OPERATION_CALLBACK

PFLT_PRE_OPERATION_CALLBACK