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 de NDIS_OID_REQUEST contiene un puntero a un búfer. Este búfer tiene el formato para contener lo siguiente:

• Estructura NDIS_RECEIVE_FILTER_PARAMETERS que especifica los parámetros de un filtro de recepción NDIS.

• Matriz de NDIS_RECEIVE_FILTER_FIELD_PARAMETERS estructuras que especifican 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:

• NDIS Packet Coalescing. Para obtener más información sobre cómo usar filtros de recepción en esta interfaz, vea 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.

• cola de máquinas virtuales (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.

Los controladores excesivos emiten solicitudes de método OID de OID_RECEIVE_FILTER_PARAMETERS para obtener los parámetros de configuración de un filtro de recepción establecido en un adaptador de red. Esto incluye un filtro de recepción que se estableció en una cola de recepción de VMQ o SR-IOV puerto virtual (VPort), así como un filtro de fusión de paquetes que se descargó en el controlador de miniport.

El controlador sobrecalado obtuvo el identificador de filtro de una solicitud de método OID anterior de OID_RECEIVE_FILTER_SET_FILTER o de solicitudes OID de OID_RECEIVE_FILTER_ENUM_FILTERS.

Códigos de estado de retorno

NDIS controla la solicitud OID de OID_RECEIVE_FILTER_PARAMETERS para controladores de miniport y devuelve uno de los siguientes códigos de estado:

NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. El 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 sobreponen proporciona un identificador de filtro no válido. Un identificador de filtro no es válido si es cero o si especifica un filtro indefinido.

NDIS_STATUS_INVALID_LENGTH
El búfer de información era demasiado corto. NDIS establece el DATA. QUERY_INFORMATION. BytesNeeded miembro 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

Consulte también

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER