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.
El uso excesivo de controladores emite solicitudes de conjunto de OID de OID_RECEIVE_FILTER_CLEAR_FILTER para borrar un filtro de recepción en un adaptador de red.
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS.
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.
La solicitud de conjunto de OID de OID_RECEIVE_FILTER_CLEAR_FILTER es obligatoria para los controladores de miniporte que admiten el fusión de paquetes NDIS, SR-IOV o interfaz VMQ.
Un controlador de sobresintroducción, como un protocolo NDIS o un controlador de filtro, usa la solicitud de conjunto de OID_RECEIVE_FILTER_CLEAR_FILTER para borrar un filtro establecido previamente. Solo el controlador que establece el filtro de recepción puede borrarlo.
El controlador de sobreslización borra un filtro de recepción estableciendo el FilterId miembro de la estructura de NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS en el identificador del filtro. El controlador obtuvo el identificador de filtro de una solicitud de método OID anterior de OID_RECEIVE_FILTER_SET_FILTER.
Instrucciones adicionales para la fusión de paquetes NDIS
El siguiente punto se aplica a los controladores de miniporte y sobreaportamiento que admiten el fusión de paquetes NDIS:
- Un controlador de sobresalto debe borrar todos los filtros de recepción que estableció en el controlador de miniporte antes de desenlace o se desasocie del controlador.
Instrucciones adicionales para la interfaz de SR-IOV
Los siguientes puntos se aplican a los controladores de minipuerto y sobreporte que admiten la interfaz de SR-IOV:
Un controlador sobreaportante debe borrar todos los filtros que estableció en un VPort de SR-IOV antes de liberar el VPort. El controlador que se sobrepone también debe borrar todos los filtros establecidos en el VPort predeterminado antes de cerrar su enlace al adaptador de red.
Un controlador de miniport no debe indicar paquetes en un VPort no predeterminado si ha completado la solicitud OID de OID_RECEIVE_FILTER_CLEAR_FILTER para borrar el último filtro en VPort.
Nota Un controlador de minipuerto tampoco debe indicar paquetes en un VPort no predeterminado si ha completado una solicitud OID de OID_NIC_SWITCH_DELETE_VPORT para liberar VPort.
Instrucciones adicionales para la interfaz VMQ
Los siguientes puntos se aplican a los controladores de miniporte y sobreaportamiento que admiten la interfaz VMQ:
Un controlador que supere el tamaño debe borrar todos los filtros establecidos en una cola de recepción de VMQ antes de liberar la cola. El controlador de sobreserción también debe borrar todos los filtros establecidos en las colas predeterminadas o quitar antes de cerrar su enlace al adaptador de red.
Un controlador de miniport no debe indicar paquetes en una cola de recepción si ha completado la solicitud OID de OID_RECEIVE_FILTER_CLEAR_FILTER para borrar el último filtro de la cola de recepción.
Nota Un controlador de minipuerto tampoco debe indicar paquetes en una cola de recepción si ha completado una solicitud OID de OID_RECEIVE_FILTER_FREE_QUEUE para liberar la cola de recepción.
Códigos de estado de retorno
La función MiniportOidRe quest del controlador de miniporte devuelve uno de los siguientes valores para esta solicitud:
| Término | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
El controlador de miniporte completó correctamente la solicitud. |
NDIS_STATUS_PENDING |
El controlador de minipuerto completará la solicitud de forma asincrónica. Después de que el controlador de miniporte haya completado todo el procesamiento, debe realizarse correctamente la solicitud llamando al función NdisMOidRequestComplete, pasando NDIS_STATUS_SUCCESS para el parámetro Status de. |
NDIS_STATUS_NOT_ACCEPTED |
El adaptador de miniporte se ha quitado sorpresa. |
NDIS devuelve uno de los siguientes códigos de estado para esta solicitud:
NDIS_STATUS_SUCCESS
El filtro especificado se ha borrado correctamente.
NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. NDIS pasará 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_FILE_NOT_FOUND
El identificador de filtro no es válido.
NDIS_STATUS_INVALID_LENGTH
El búfer de información es demasiado pequeño. NDIS establece el DATA. SET_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
Requisitos
Versión |
Se admite en NDIS 6.20 y versiones posteriores. |
Encabezado |
Ntddndis.h (include Ndis.h) |