NDIS_PD_CLEAR_RECEIVE_FILTER función de devolución de llamada (ndis.h)
La plataforma PacketDirect (PD) llama a la función NdisPDClearReceiveFilter del controlador de miniporte compatible con PD para borrar este filtro de la plataforma pd.
Sintaxis
NDIS_PD_CLEAR_RECEIVE_FILTER NdisPdClearReceiveFilter;
VOID() NdisPdClearReceiveFilter(
[in] NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}
Parámetros
[in] FilterHandle
Identificador de un filtro de plataforma pd.
Valor devuelto
Esta función de devolución de llamada no devuelve un valor.
Comentarios
Después de que esta función vuelva, se garantiza que ningún paquete recién llegado coincida con este filtro. Sin embargo, es posible que todavía haya paquetes en curso que ya coincidan con este filtro y que estén en camino de colocarse en la cola de recepción de destino.
Ejemplos
Para definir una función NdisPDClearReceiveFilter , primero debe proporcionar una declaración de función que identifique el tipo de función que está definiendo. Windows proporciona un conjunto de tipos de función para controladores. Declarar una función mediante los tipos de función ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación a encontrar errores y es un requisito para escribir controladores para el sistema operativo Windows.Por ejemplo, para definir una función NdisPDClearReceiveFilter denominada "MyPDClearReceiveFilter", use el tipo NDIS_PD_CLEAR_RECEIVE_FILTER como se muestra en este ejemplo de código:
NDIS_PD_CLEAR_RECEIVE_FILTER MyPDClearReceiveFilter;
A continuación, implemente la función de la siguiente manera:
_Use_decl_annotations_
VOID
MyPDClearReceiveFilter(
NDIS_PD_FILTER_HANDLE FilterHandle
)
{...}
El tipo de función NDIS_PD_CLEAR_RECEIVE_FILTER se define en el archivo de encabezado Ntddndis.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función NDIS_PD_CLEAR_RECEIVE_FILTER en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante el uso de tipos de roles de función para controladores NDIS.
Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 10 |
Servidor mínimo compatible | Windows Server 2016 |
Plataforma de destino | Windows |
Encabezado | ndis.h |
IRQL | PASSIVE_LEVEL |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de