Compartir a través de

Enumeración de filtros en una máquina virtual

  • Artículo

Para obtener una lista de todos los filtros que se establecen en una cola de recepción, los controladores y las aplicaciones que se sobreponen pueden usar la solicitud de identificador de objeto de método (OID) de OID_RECEIVE_FILTER_ENUM_FILTERS .

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene inicialmente un puntero a una estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY . Cuando da formato a la estructura NDIS_RECEIVE_FILTER_INFO_ARRAY , el controlador o la aplicación que se sobrepone deben establecer el miembro QueueId en el identificador (ID) de la cola de recepción. El identificador de la cola de recepción se obtiene de las siguientes maneras:

  • El controlador de sobreslización obtuvo el valor del identificador de cola de recepción de las solicitudes anteriores del método OID de OID_RECEIVE_FILTER_ALLOCATE_QUEUE o OID_RECEIVE_FILTER_ENUM_QUEUES. El controlador también puede especificar NDIS_DEFAULT_RECEIVE_QUEUE_ID para la cola de recepción predeterminada.

  • Una aplicación obtuvo el valor de id. de cola de recepción de una solicitud de método OID anterior de OID_RECEIVE_FILTER_ENUM_QUEUES. La aplicación también puede especificar NDIS_DEFAULT_RECEIVE_QUEUE_ID para la cola de recepción predeterminada.

Después de una devolución correcta de la solicitud de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS, el miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_RECEIVE_FILTER_INFO_ARRAY actualizada seguida de una o varias estructuras de NDIS_RECEIVE_FILTER_INFO . Cada estructura de NDIS_RECEIVE_FILTER_INFO especifica el identificador de un filtro que se establece en la cola de recepción especificada.

Los controladores o aplicaciones que se sobreponen pueden usar la solicitud de método OID de OID_RECEIVE_FILTER_PARAMETERS para obtener los parámetros de un filtro específico en una cola de recepción.

El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene inicialmente un puntero a una estructura de NDIS_RECEIVE_FILTER_PARAMETERS . El controlador o la aplicación de sobresuso da formato a la estructura de NDIS_RECEIVE_FILTER_PARAMETERS estableciendo el miembro FilterId en el valor de identificador distinto de cero del filtro cuyos parámetros se van a devolver.

Nota El controlador de sobreslización obtuvo el identificador de filtro de una solicitud de método OID anterior de OID_RECEIVE_FILTER_SET_FILTER o OID_RECEIVE_FILTER_ENUM_FILTERS. La aplicación solo puede obtener el identificador de filtro de una solicitud de método OID anterior de OID_RECEIVE_FILTER_ENUM_FILTERS.

NDIS controla las solicitudes de OID de OID_RECEIVE_FILTER_ENUM_FILTERS y OID_RECEIVE_FILTER_PARAMETERS método para controladores de minipuerto. NDIS obtuvo la información de una memoria caché interna de los datos que recibió de la solicitud de OID de OID_RECEIVE_FILTER_SET_FILTER .