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

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

Синтаксис

NTSTATUS FLTAPI FltDeleteVolumeContext(
  [in]            PFLT_FILTER  Filter,
  [in]            PFLT_VOLUME  Volume,
  [out, optional] PFLT_CONTEXT *OldContext
);

Параметры

[in] Filter

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

[in] Volume

Непрозрачный указатель тома для тома.

[out, optional] OldContext

Указатель на выделенную вызывающим переменную, которая получает адрес удаленного контекста. Этот параметр является необязательным и может быть null. Если OldContext не NULL и не указывает на NULL_CONTEXT, вызывающий объект отвечает за вызов FltReleaseContext, чтобы освободить этот контекст, если он больше не нужен.

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

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

Замечания

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

Так как контексты считаются ссылочными, обычно не требуется для вызова подпрограммы, такой как FltDeleteVolumeContext для явного удаления контекста.

Драйвер минифильтра вызывает FltDeleteVolumeContext, чтобы удалить контекст из тома и пометить контекст для удаления. Контекст обычно освобождается немедленно, если в нем нет незавершенной ссылки (например, так как контекст по-прежнему используется другим потоком).

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

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

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

Требования

См. также

FltAllocateContext

FltDeleteContext

FltGetVolumeContext

FltReleaseContext

FltSetVolumeContext