FLT_RELATED_OBJECTS 結構 (fltkernel.h)

發行項
03/01/2024

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，則包含交易迷你版本標識碼值的不透明成員。如果 Transaction 為 NULL， 則 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結構之對應 Instance 或 FileObject 成員的值。如需詳細資訊，請參閱修改 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;