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

Подпрограмма FltGetVolumeContext извлекает контекст, заданный для тома заданным драйвером минифильтра.

Синтаксис

NTSTATUS FLTAPI FltGetVolumeContext(
  [in]  PFLT_FILTER  Filter,
  [in]  PFLT_VOLUME  Volume,
  [out] PFLT_CONTEXT *Context
);

Параметры

[in] Filter

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

[in] Volume

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

[out] Context

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

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

FltGetVolumeContext возвращает STATUS_SUCCESS, когда он успешно возвращает запрошенный контекст. В противном случае возвращается соответствующее значение NTSTATUS, например следующее:

Замечания

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

FltGetVolumeContext увеличивает количество ссылок в контексте, на который указывает параметр контекста Context. Если этот указатель контекста больше не нужен, вызывающий объект должен уменьшать количество ссылок путем вызова FltReleaseContext. Таким образом, каждый успешный вызов FltGetVolumeContext должен соответствовать последующему вызову FltReleaseContext.

Чтобы задать контекст для тома, вызовите FltSetVolumeContext.

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

Чтобы удалить контекст тома, вызовите FltDeleteVolumeContext или FltDeleteContext.

Требования

См. также

FltAllocateContext

FltDeleteContext

FltDeleteVolumeContext

FltReleaseContext

FltSetVolumeContext