OID_RECEIVE_FILTER_PARAMETERS
Un controlador demasiado excesivo emite una solicitud de método OID de OID_RECEIVE_FILTER_PARAMETERS para obtener los parámetros de configuración actuales de un filtro en un adaptador de red.
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura NDIS_RECEIVE_FILTER_PARAMETERS . NDIS usa el miembro FilterId en la estructura de entrada para identificar el filtro.
Después de una devolución correcta de la solicitud del método OID, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer tiene el formato siguiente:
Estructura NDIS_RECEIVE_FILTER_PARAMETERS que especifica los parámetros de un filtro de recepción NDIS.
Matriz de estructuras de NDIS_RECEIVE_FILTER_FIELD_PARAMETERS que especifica el criterio de prueba de filtro para un campo en un encabezado de paquete de red.
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.
El exceso de controladores emite solicitudes de método OID de OID_RECEIVE_FILTER_PARAMETERS para obtener los parámetros de configuración de un filtro de recepción que se estableció en un adaptador de red. Esto incluye un filtro de recepción que se estableció en una cola de recepción de VMQ o un puerto virtual SR-IOV (VPort), así como un filtro de fusión de paquetes que se descargó en el controlador de miniport.
El controlador de sobreaprovisionamiento obtuvo el identificador de filtro de una solicitud de método de OID anterior de OID_RECEIVE_FILTER_SET_FILTER o de solicitudes de OID de OID_RECEIVE_FILTER_ENUM_FILTERS.
Códigos de estado de devolución
NDIS controla la solicitud OID de OID_RECEIVE_FILTER_PARAMETERS para controladores de miniporte 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_PARAMETERS.
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_PARAMETER
El controlador o la aplicación que se sobreponen proporcionan un identificador de filtro no válido. Un identificador de filtro no es válido si es cero o si especifica un filtro no definido.
NDIS_STATUS_INVALID_LENGTH
El búfer de información era demasiado corto. NDIS establece data . QUERY_INFORMATION. Miembro BytesNeeded de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
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) |
Consulte también
OID_RECEIVE_FILTER_ENUM_FILTERS