Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La rutina FltEnumerateInstanceInformationByFilter proporciona información sobre las instancias de un controlador de minifiltro determinado.
Sintaxis
NTSTATUS FLTAPI FltEnumerateInstanceInformationByFilter(
[in] PFLT_FILTER Filter,
[in] ULONG Index,
[in] INSTANCE_INFORMATION_CLASS InformationClass,
[out] PVOID Buffer,
[in] ULONG BufferSize,
[out] PULONG BytesReturned
);
Parámetros
[in] Filter
Puntero de filtro opaco para el autor de la llamada.
[in] Index
Índice de base cero de la instancia para la que se solicita la información.
[in] InformationClass
Tipo de información solicitada. Este parámetro puede tener uno de los siguientes valores.
| Valor | Significado |
|---|---|
| InstanceBasicInformation | El búfer al que apunta el parámetro buffer de recibe una estructura de INSTANCE_BASIC_INFORMATION para la instancia. |
| instanceFullInformation | El búfer al que apunta el parámetro buffer de recibe una estructura INSTANCE_FULL_INFORMATION para la instancia. |
| InstancePartialInformation | El búfer al que apunta el parámetro buffer de recibe una estructura de INSTANCE_PARTIAL_INFORMATION para la instancia. |
| InstanceAggregateStandardInformation | El búfer al que apunta el parámetro buffer recibe una estructura INSTANCE_AGGREGATE_STANDARD_INFORMATION para la instancia. La parte LegacyFilter de la estructura no se utiliza. Esta estructura está disponible a partir de Windows Vista. |
[out] Buffer
Puntero a un búfer asignado por el autor de la llamada que recibe la información solicitada. El tipo de la información devuelta en el búfer se define mediante el parámetro InformationClass.
[in] BufferSize
Tamaño, en bytes, del búfer al que apunta el Búfer parámetro. El autor de la llamada debe establecer este parámetro según el valor de InformationClass especificado.
[out] BytesReturned
Puntero a una variable asignada por el autor de la llamada que recibe el número de bytes devueltos en el búfer al que apunta buffer . Si el valor de entrada de BufferSize es demasiado pequeño, FltEnumerateInstanceInformationByFilter devuelve STATUS_BUFFER_TOO_SMALL y establece esta variable en el número de bytes necesarios para almacenar la información solicitada. Este parámetro es necesario y no se puede null.
Valor devuelto
fltEnumerateInstanceInformationByFilter devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:
| Código devuelto | Descripción |
|---|---|
|
El búfer al que apunta el Búfer no es lo suficientemente grande como para almacenar la información solicitada. Se trata de un código de error. |
|
Se encontró una instancia coincidente, pero se está descomponiéndose. Se trata de un código de error. |
|
Se especificó un valor no válido para el parámetro InformationClass. Por ejemplo, si filterAggregateStandardInformation se especifica en un sistema operativo antes de Windows Vista, la rutina devolverá STATUS_INVALID_PARAMETER. Se trata de un código de error. |
|
No hay más entradas en la lista de instancias del controlador de minifiltro. Se trata de un código de advertencia. |
Observaciones
El parámetro Index es simplemente una manera de FltEnumerateInstanceInformationByFilter seleccionar entre las instancias de la lista de instancias del controlador de minifiltro especificado por Filter. Dado que las instancias del controlador de minifiltro de la lista de instancias pueden cambiar en cualquier momento, dos llamadas a FltEnumerateInstanceInformationByFilter con el mismo Index y Valores de filtro no se garantiza que devuelvan el mismo resultado.
Para enumerar todos los controladores de minifiltro registrados, llame a FltEnumerateFilters.
Para enumerar la información de filtro de todos los controladores de minifiltro registrados, llame a FltEnumerateFilterInformation.
Para obtener información de filtro para un controlador de minifiltro determinado, llame a FltGetFilterInformation.
Para enumerar todas las instancias del controlador de minifiltro en un volumen determinado, llame a FltEnumerateInstanceInformationByVolume.
Para enumerar instancias de todos los controladores de minifiltro en todos los volúmenes, llame a FltEnumerateInstances.
Para enumerar todos los volúmenes que se conocen en el Administrador de filtros, llame a FltEnumerateVolumes.
.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | fltkernel.h (incluya FltKernel.h) |
| biblioteca de | FltMgr.lib |
| irQL | <= APC_LEVEL |
Consulte también
FltEnumerateInstanceInformationByVolume