Función FilterInstanceCreate (fltuser.h)
La función FilterInstanceCreate crea un identificador que se puede usar para comunicarse con la instancia de minifiltro especificada.
Sintaxis
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
Parámetros
[in] lpFilterName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del minifiltro que posee la instancia.
[in] lpVolumeName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre del volumen al que está asociada la instancia.
La cadena de entrada lpVolumeName puede ser cualquiera de las siguientes. La barra diagonal inversa final (\) es opcional.
- Una letra de unidad, como "D:\"
- Ruta de acceso a un punto de montaje de volumen, como "c:\mnt\edrive\"
- Un identificador de volumen único (también denominado nombre GUID de volumen), como "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Un nombre de dispositivo no persistente (también denominado nombre de destino o un nombre de dispositivo NT), como "\Device\HarddiskVolume1\"
[in, optional] lpInstanceName
Puntero a una cadena de caracteres anchos terminada en NULL que contiene el nombre de instancia de la instancia. Este parámetro es opcional y puede ser NULL. Si es NULL, se devuelve la primera instancia encontrada para este minifiltro en este volumen.
[out] hInstance
Puntero a una variable asignada por el autor de la llamada que recibe un identificador opaco para la instancia de minifiltro si la llamada a FilterInstanceCreate se realiza correctamente; de lo contrario, recibe INVALID_HANDLE_VALUE.
Valor devuelto
FilterInstanceCreate devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error.
Comentarios
Una aplicación en modo de usuario llama a FilterInstanceCreate para crear un identificador que se pueda usar para comunicarse con una instancia de minifiltro en modo kernel. El identificador de instancia devuelto se puede pasar como parámetro a funciones como FilterInstanceGetInformation.
Para cerrar un identificador de instancia devuelto por FilterInstanceCreate, llame a FilterInstanceClose.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | fltuser.h (incluya Fltuser.h) |
| Library | FltLib.lib |
| Archivo DLL | FltLib.dll |