Функция FilterInstanceCreate (fltuser.h)

Статья
02/27/2024

Функция FilterInstanceCreate создает дескриптор, который можно использовать для взаимодействия с данным экземпляром минифильтра.

Синтаксис

HRESULT FilterInstanceCreate(
  [in]           LPCWSTR          lpFilterName,
  [in]           LPCWSTR          lpVolumeName,
  [in, optional] LPCWSTR          lpInstanceName,
  [out]          HFILTER_INSTANCE *hInstance
);

Параметры

[in] lpFilterName

Указатель на строку расширенных символов с завершением NULL, содержащую имя минифильтра, которому принадлежит экземпляр .

[in] lpVolumeName

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

Входная строка lpVolumeName может быть любой из следующих. Обратная косая черта в конце (\) является необязательной.

Буква диска, например "D:\"
Путь к точке подключения тома, например "c:\mnt\edrive\"
Уникальный идентификатор тома (также называемый именем GUID тома), например "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
Имя устройства, не являющееся неотстоятельным (также называемое целевым именем или именем устройства NT), например "\Device\HarddiskVolume1\"

[in, optional] lpInstanceName

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

[out] hInstance

Указатель на переменную, выделенную вызывающим объектом, которая получает непрозрачный дескриптор для экземпляра минифильтра при успешном вызове FilterInstanceCreate ; В противном случае он получает INVALID_HANDLE_VALUE.

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

FilterInstanceCreate возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.

Приложение пользовательского режима вызывает FilterInstanceCreate , чтобы создать дескриптор, который можно использовать для взаимодействия с экземпляром минифильтра в режиме ядра. Возвращенный дескриптор экземпляра можно передать в качестве параметра в такие функции, как FilterInstanceGetInformation.

Чтобы закрыть дескриптор экземпляра, возвращенный FilterInstanceCreate, вызовите FilterInstanceClose.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltuser.h (включая Fltuser.h)
Библиотека	FltLib.lib
DLL	FltLib.dll

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

FilterInstanceClose

FilterInstanceGetInformation

Поделиться через