Функция FilterInstanceCreate (fltuser.h)
Функция 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 |