Función NdisEnumerateFilterModules (ndis.h)
La función NdisEnumerateFilterModules enumera todos los módulos de filtros y filtra instancias de controlador intermedio en una pila de filtros.
Sintaxis
NDIS_STATUS NdisEnumerateFilterModules(
[in] NDIS_HANDLE NdisHandle,
[in] PVOID InterfaceBuffer,
[in] ULONG InterfaceBufferLength,
[in, out] PULONG BytesNeeded,
[in, out] PULONG BytesWritten
);
Parámetros
[in] NdisHandle
Identificador NDIS que se obtuvo durante la inicialización del autor de la llamada. Para obtener más información sobre este identificador, consulte Obtención de identificadores de grupo.
Si el controlador es un controlador de adaptador de miniporte NDIS, NDIS devuelve información sobre todos los módulos de interfaz que están conectados actualmente al adaptador de miniporte, empezando por el módulo de filtro superior.
Si el identificador es un identificador de enlace NDIS, NDIS devuelve información sobre todos los módulos de filtro que están conectados actualmente al adaptador de minipuerto subyacente, empezando por el módulo de filtro superior.
Si el identificador es un identificador de módulo de filtro NDIS, NDIS devuelve información sobre todos los módulos de filtro que están conectados actualmente al adaptador de minipuerto subyacente al que está asociado el módulo de filtro especificado, empezando por el módulo de filtro superior.
[in] InterfaceBuffer
Puntero a un bloque de memoria asignado por el autor de la llamada en el que NDIS devuelve la información de todos los módulos de filtro de una pila de filtros, empezando por el filtro más alto. Este búfer contiene una estructura de NDIS_ENUM_FILTERS seguida de cero o más estructuras NDIS_FILTER_INTERFACE , una para cada módulo de filtro de la pila.
[in] InterfaceBufferLength
Longitud, en bytes, del bloque de memoria proporcionado por el autor de la llamada en el miembro InterfaceBuffer .
[in, out] BytesNeeded
Puntero a una variable proporcionada por el autor de la llamada donde NDIS escribe el número total de bytes que NDIS requiere para devolver correctamente la información de la interfaz para todos los filtros de la pila de filtros.
[in, out] BytesWritten
Puntero a una variable proporcionada por el autor de la llamada donde NDIS escribe el total de bytes que NDIS escribió en la memoria en InterfaceBuffer.
Valor devuelto
NdisEnumerateFilterModules devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
La operación se ha completado correctamente. |
|
Error de NdisEnumerateFilterModules porque el parámetro NdisHandle no era un adaptador de miniporte NDIS válido, enlace de protocolo o identificador de módulo de filtro. |
|
Error de NdisEnumerateFilterModules porque el búfer proporcionado en el parámetro InterfaceBuffer era demasiado corto para que NDIS devuelva toda la información. Si se escribió un resultado parcial en InterfaceBuffer, el valor en el parámetro BytesWritten contiene la longitud de los resultados parciales. |
Comentarios
Un controlador de miniporte NDIS, controlador de protocolo o controlador de filtro puede llamar a la función NdisEnumerateFilterModules para enumerar todos los filtros de una pila de filtros.
NdisEnumerateFilterModules devuelve la lista de módulos de filtro y filtra los controladores intermedios de la parte superior a la parte inferior de la pila de controladores. Por ejemplo, si los módulos de filtro (F1 y F2) están conectados al adaptador de minipuerto (M1) y si F2 está por encima de F1, NdisEnumerateFilterModules devuelve la lista en el orden siguiente: F2, F1. Si también hay un controlador intermedio de filtro (M2) enlazado a M1, si M2 está por encima de F2 y si otro filtro (F3) está asociado a M2, NdisEnumerateFilterModules devuelve la lista de filtros en el orden siguiente: F3, M2, F2, F1.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite en NDIS 6.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | Irql_Filter_Driver_Function(ndis) |