Функция FltSetStreamContext (fltkernel.h)

Подпрограмма FltSetStreamContext задает контекст для потока файлов.

Синтаксис

NTSTATUS FLTAPI FltSetStreamContext(
  [in]  PFLT_INSTANCE             Instance,
  [in]  PFILE_OBJECT              FileObject,
  [in]  FLT_SET_CONTEXT_OPERATION Operation,
  [in]  PFLT_CONTEXT              NewContext,
  [out] PFLT_CONTEXT              *OldContext
);

Параметры

[in] Instance

Указатель непрозрачного экземпляра для экземпляра драйвера минифильтра, контекст которого должен быть вставлен, удален или заменен в списке контекстов, присоединенных к потоку файлов.

[in] FileObject

Указатель на объект файла для файлового потока.

[in] Operation

Флаг, указывающий сведения о выполняемой операции. Этот параметр должен иметь один из следующих значений:

[in] NewContext

Указатель на новый контекст для файлового потока. Этот параметр является обязательным и не может иметь значение NULL.

[out] OldContext

Указатель на переменную, выделенную вызывающим объектом, которая получает адрес существующего контекста потока для параметра Instance , если он уже задан. Этот параметр является необязательным и может иметь значение NULL. Дополнительные сведения об этом параметре см. в следующем разделе Примечаний.

Возвращаемое значение

Подпрограмма FltSetStreamContext возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:

Комментарии

Дополнительные сведения о контекстах см. в разделе О контекстах минифильтра.

Драйвер минифильтра вызывает FltSetStreamContext для подключения контекста потока к потоку файлов, а также для удаления или замены существующего контекста потока. Драйвер минифильтра может прикрепить один контекст для каждого экземпляра драйвера минифильтра к потоку файлов.

Не удается вызвать FltSetStreamContext для нераскрытого объекта FileObject. Следовательно, его нельзя вызвать из предварительно созданного обратного вызова для потока, так как поток не был открыт в этот момент. Однако драйвер минифильтра может выделить и настроить контекст потока в обратном вызове перед созданием, передать его в обратный вызов после создания с помощью параметра контекста завершения и задать контекст потока в потоке в обратном вызове после создания.

Подсчет ссылок

Если fltSetStreamContext успешно выполняется:

• Число ссылок в NewContext увеличивается. Если NewContext больше не требуется, минифильтр должен вызвать FltReleaseContext для уменьшения количества ссылок.

В противном случае, если FltSetStreamContext завершается сбоем :

• Количество ссылок в NewContext остается неизменным.
• Если значение OldContext не равно NULL и не указывает на NULL_CONTEXT то OldContext является указателем на контекст, связанный в данный момент с потоком. Фильтр, вызывающий FltSetStreamContext , должен вызывать FltReleaseContext для OldContext , если указатель контекста больше не нужен.

Независимо от успеха:

• Фильтр, вызывающий FltSetStreamContext , должен вызывать FltReleaseContext для уменьшения количества ссылок на объект NewContext , который был увеличен с помощью FltAllocateContext.

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

Другие контекстные операции

Дополнительные сведения см . в разделах Настройка контекстов и Освобождение контекстов:

• Чтобы определить, поддерживаются ли контексты потока для заданного файла, вызовите FltSupportsStreamContexts.

• Чтобы выделить новый контекст, вызовите FltAllocateContext.

• Чтобы получить контекст потока, вызовите FltGetStreamContext.

• Чтобы удалить контекст потока, вызовите Метод FltDeleteStreamContext или FltDeleteContext.

Требования

См. также раздел

FltAllocateContext

FltDeleteContext

FltDeleteStreamContext

FltGetStreamContext

FltReleaseContext