OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
El exceso de controladores emite solicitudes de consulta de OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES para obtener las funcionalidades de filtrado de recepción habilitadas actualmente de un adaptador de red.
Después de una devolución correcta de la solicitud de consulta OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_FILTER_CAPABILITIES .
Observaciones
Los filtros de recepción NDIS se usan en las siguientes interfaces NDIS:
Fusión de paquetes NDIS. Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, consulte Administración de filtros de recepción de fusión de paquetes.
Virtualización de E/S raíz única (SR-IOV). Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, vea Establecer un filtro de recepción en un puerto virtual.
Virtual Machine Queue (VMQ). Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, consulte Configuración y borrado de filtros de VMQ.
A partir de NDIS 6.20, los controladores de minipuerto registran las funcionalidades de hardware de filtrado de recepción habilitadas actualmente del adaptador de red cuando se llama a su función MiniportInitializeEx . Los controladores de miniporte registran estas funcionalidades siguiendo estos pasos:
El controlador inicializa una estructura de NDIS_RECEIVE_FILTER_CAPABILITIES con las funcionalidades de hardware de filtrado habilitadas actualmente.
El controlador inicializa una estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES y establece el miembro CurrentReceiveFilterCapabilities en un puntero a la estructura NDIS_RECEIVE_FILTER_CAPABILITIES .
El controlador de minipuerto llama a la función NdisMSetMiniportAttributes y establece el parámetro MiniportAttributes en un puntero a una estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
El protocolo excesivo y los controladores de filtro no tienen que emitir solicitudes de consulta de OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. NDIS proporciona las funcionalidades de filtrado de recepción habilitadas actualmente para estos controladores de la siguiente manera:
NDIS proporciona las funcionalidades de filtrado de recepción habilitadas actualmente de un adaptador de red subyacente a controladores de protocolo excesivos en el miembro ReceiveFilterCapabilities de la estructura NDIS_BIND_PARAMETERS durante la operación de enlace.
NDIS proporciona las funcionalidades de filtrado de recepción habilitadas actualmente de un adaptador de red subyacente a controladores de filtro excesivos en el miembro ReceiveFilterCapabilities de la estructura NDIS_FILTER_ATTACH_PARAMETERS durante la operación de asociación.
Códigos de estado de devolución
NDIS controla la solicitud de consulta OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES para controladores de minipuerto y devuelve uno de los siguientes códigos de estado:
NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. InformationBuffer apunta a una estructura de NDIS_RECEIVE_FILTER_CAPABILITIES.
NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. NDIS pasa el código de estado final y los resultados al controlador de finalización de solicitudes OID del autor de la llamada una vez completada la solicitud.
NDIS_STATUS_INVALID_LENGTH
El búfer de información era demasiado corto. NDIS establece los DATOS. QUERY_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_NOT_SUPPORTED
El adaptador de red no admite el filtrado de recepción.
NDIS_STATUS_FAILURE
Error en la solicitud por otros motivos.
Requisitos
Versión |
Se admite en NDIS 6.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |