FILTER_DEVICE_PNP_EVENT_NOTIFY función de devolución de llamada (ndis.h)

Artículo
02/26/2024

NDIS llama a la función FilterDevicePnPEventNotify de un controlador de filtro para notificar al controlador de los eventos de administración de energía y Plug and Play del dispositivo (PnP).

Nota Debe declarar la función mediante el tipo FILTER_DEVICE_PNP_EVENT_NOTIFY . Para obtener más información, consulte la sección Ejemplos siguientes.

Sintaxis

FILTER_DEVICE_PNP_EVENT_NOTIFY FilterDevicePnpEventNotify;

void FilterDevicePnpEventNotify(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNET_DEVICE_PNP_EVENT NetDevicePnPEvent
)
{...}

Parámetros

[in] FilterModuleContext

Identificador del área de contexto del módulo de filtro. El controlador de filtro creó e inicializó este área de contexto en la función FilterAttach .

[in] NetDevicePnPEvent

Puntero a una estructura de NET_DEVICE_PNP_EVENT que describe un evento de Plug and Play de dispositivo.

Valor devuelto

None

Observaciones

FilterDevicePnPEventNotify es una función opcional. Si un controlador de filtro no usa solicitudes PnP del dispositivo, puede establecer el punto de entrada de esta función en NULL cuando llama a . Función NdisFRegisterFilterDriver .

FilterDevicePnPEventNotify es similar a un controlador de minipuerto Función MiniportDevicePnPEventNotify . Los controladores de filtro pueden reenviar estas notificaciones a los controladores subyacentes. Para reenviar una solicitud, llame a Función NdisFDevicePnPEventNotify .

NDIS llama a FilterDevicePnPEventNotify en IRQL = PASSIVE_LEVEL.

Ejemplos

Para definir una función FilterDevicePnPEventNotify , primero debe proporcionar una declaración de función que identifique el tipo de función que va a definir. 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 FilterDevicePnPEventNotify denominada "MyDevicePPEventNotify", use el tipo de FILTER_DEVICE_PNP_EVENT_NOTIFY como se muestra en este ejemplo de código:

FILTER_DEVICE_PNP_EVENT_NOTIFY MyDevicePnPEventNotify;

A continuación, implemente la función de la siguiente manera:

_Use_decl_annotations_
VOID
 MyDevicePnPEventNotify(
    NDIS_HANDLE  FilterModuleContext,
    PNET_DEVICE_PNP_EVENT  NetDevicePnPEvent
    )
  {...}

El tipo de función FILTER_DEVICE_PNP_EVENT_NOTIFY se define en el archivo de encabezado Ndis.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 FILTER_DEVICE_PNP_EVENT_NOTIFY en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, vea Declarar funciones mediante 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	Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino	Windows
Encabezado	ndis.h (incluya Ndis.h)
IRQL	PASSIVE_LEVEL