структура FLT_RELATED_CONTEXTS (fltkernel.h)

Статья
08/07/2023

Структура FLT_RELATED_CONTEXTS содержит контексты драйвера минифильтра для объектов, связанных с операцией ввода-вывода.

Синтаксис

typedef struct _FLT_RELATED_CONTEXTS {
  PFLT_CONTEXT VolumeContext;
  PFLT_CONTEXT InstanceContext;
  PFLT_CONTEXT FileContext;
  PFLT_CONTEXT StreamContext;
  PFLT_CONTEXT StreamHandleContext;
  PFLT_CONTEXT TransactionContext;
} FLT_RELATED_CONTEXTS, *PFLT_RELATED_CONTEXTS;

Члены

VolumeContext

Непрозрачный указатель на контекст минифильтра для тома, на который указывает элемент Volumeструктуры FLT_RELATED_OBJECTS .

InstanceContext

Непрозрачный указатель на контекст драйвера минифильтра для экземпляра, на который указывает элемент экземпляраструктуры FLT_RELATED_OBJECTS .

FileContext

В Windows Vista и более поздних версиях этот элемент является непрозрачным указателем на контекст драйвера минифильтра для каждого файла для дескриптора потока, на который указывает элемент FileObjectструктуры FLT_RELATED_OBJECTS . В операционных системах Windows, предшествующих Windows Vista, этот элемент зарезервирован для использования системой.

StreamContext

Непрозрачный указатель на контекст потока минифильтра для дескриптора потока, на который указывает элемент FileObjectструктуры FLT_RELATED_OBJECTS .

StreamHandleContext

Непрозрачный указатель на контекст дескриптора потока минифильтра для дескриптора потока, на который указывает элемент FileObjectструктуры FLT_RELATED_OBJECTS .

TransactionContext

В Windows Vista и более поздних версиях этот элемент является непрозрачным указателем на контекст транзакции минифильтра для транзакции, на которую указывает элемент Transactionструктуры FLT_RELATED_OBJECTS . В операционных системах Windows, предшествующих Windows Vista, этот элемент зарезервирован для использования системой.

Структура FLT_RELATED_CONTEXTS содержит контексты драйвера минифильтра для объектов, связанных с операцией ввода-вывода или операцией установки или удаления экземпляра.

Драйвер минифильтра использует структуру FLT_RELATED_CONTEXTS для получения нескольких контекстов для данной операции. Для этого драйвер минифильтра выделяет пустую структуру FLT_RELATED_CONTEXTS и передает указатель на него в качестве параметра Contextsв FltGetContexts.

Минифильтр также может использовать эту структуру для освобождения нескольких контекстов для данной операции. Для этого драйвер минифильтра передает указатель на FLT_RELATED_CONTEXTS в качестве параметра Contexts в FltReleaseContexts.

Дополнительные сведения об использовании контекстов см. в справочной записи для FltAllocateContext.