estructura NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS (ndis.h)

Artículo
08/07/2023

Un controlador de miniporte NDIS define sus características de interrupción en una estructura de NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS y pasa la estructura a la Función NdisMRegisterInterruptEx .

Sintaxis

typedef struct _NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                     Header;
  MINIPORT_ISR_HANDLER                   InterruptHandler;
  MINIPORT_INTERRUPT_DPC_HANDLER         InterruptDpcHandler;
  MINIPORT_DISABLE_INTERRUPT_HANDLER     DisableInterruptHandler;
  MINIPORT_ENABLE_INTERRUPT_HANDLER      EnableInterruptHandler;
  BOOLEAN                                MsiSupported;
  BOOLEAN                                MsiSyncWithAllMessages;
  MINIPORT_MSI_ISR_HANDLER               MessageInterruptHandler;
  MINIPORT_MSI_INTERRUPT_DPC_HANDLER     MessageInterruptDpcHandler;
  MINIPORT_DISABLE_MSI_INTERRUPT_HANDLER DisableMessageInterruptHandler;
  MINIPORT_ENABLE_MSI_INTERRUPT_HANDLER  EnableMessageInterruptHandler;
  NDIS_INTERRUPT_TYPE                    InterruptType;
  PIO_INTERRUPT_MESSAGE_INFO             MessageInfoTable;
} NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS, *PNDIS_MINIPORT_INTERRUPT_CHARACTERISTICS;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS. Establezca el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_MINIPORT_INTERRUPT, el miembro Revision en NDIS_MINIPORT_INTERRUPT_REVISION_1 y el miembro Size en NDIS_SIZEOF_MINIPORT_INTERRUPT_CHARACTERISTICS_REVISION_1.

InterruptHandler

Punto de entrada de la función MiniportInterrupt asociada a esta interrupción.

InterruptDpcHandler

Punto de entrada de la función MiniportInterruptDPC asociada a esta interrupción.

DisableInterruptHandler

El punto de entrada del Función MiniportDisableInterruptEx .

EnableInterruptHandler

El punto de entrada del Función MiniportEnableInterruptEx .

MsiSupported

Establezca este miembro en TRUE si el controlador de minipuerto admite funciones de servicio de interrupción con señal de mensaje (MSI). El controlador miniport debe proporcionar puntos de entrada para las funciones de servicio MSI.

Si se establece este valor en FALSE , se indica que no se admite MSI. Los puntos de entrada de la función de servicio MSI deben establecerse en NULL.

MsiSyncWithAllMessages

Establezca este miembro en TRUE si el controlador de minipuerto debe serializar todas las funciones del servicio MSI.

Establecer este valor en TRUE puede degradar el rendimiento de las interrupciones. Es más eficaz para varias funciones de servicio de interrupción que controlan diferentes mensajes para ejecutarse simultáneamente.

MessageInterruptHandler

El punto de entrada del Función MiniportMessageInterrupt , si existe, asociada a esta interrupción. Si el controlador no admite interrupciones de mensajes, establezca este miembro en NULL.

MessageInterruptDpcHandler

El punto de entrada del Función MiniportMessageInterruptDPC , si existe, asociada a esta interrupción. Si el controlador no admite interrupciones señaladas por mensajes, establezca este miembro en NULL.

DisableMessageInterruptHandler

El punto de entrada del Función MiniportDisableMessageInterrupt , si existe. Si el controlador no admite interrupciones señaladas de mensaje, establezca este miembro en NULL.

EnableMessageInterruptHandler

El punto de entrada del Función MiniportEnableMessageInterrupt , si existe. Si el controlador no admite interrupciones señaladas por mensajes, establezca este miembro en NULL.

InterruptType

Variable de tipo NDIS_INTERRUPT_TYPE. NDIS establece esta variable para indicar qué tipo de interrupción concedió al controlador de miniporte. Si el controlador admite MSI, debe comprobar este valor si NdisMRegisterInterruptEx devuelve NDIS_STATUS_SUCCESS. Si InterruptType se establece en NDIS_CONNECT_LINE_BASED, NDIS concedió al controlador una interrupción basada en línea, lo que puede ocurrir incluso si el controlador admite interrupciones señaladas por mensajes. Si InterruptType se establece en NDIS_CONNECT_MESSAGE_BASED, NDIS concedió al controlador una interrupción señalada por mensaje. En este caso, el controlador puede acceder a MessageInfoTable para obtener la información de interrupción.

MessageInfoTable

Puntero proporcionado por NDIS a un IO_INTERRUPT_MESSAGE_INFO estructura.

Si InterruptType es NDIS_CONNECT_MESSAGE_BASED, NDIS inicializa una estructura de IO_INTERRUPT_MESSAGE_INFO con información sobre la interrupción y establece MessageInfoTable en un puntero a la estructura. Los controladores de minipuerto no deben modificar la estructura.
Si InterruptType está NDIS_CONNECT_LINE_BASED, MessageInfoTable debe ser NULL.

Comentarios

Un controlador de minipuerto llama a la función NdisMRegisterInterruptEx para registrar una interrupción. El controlador asigna e inicializa una estructura de NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS para especificar las características de interrupción y los puntos de entrada del controlador y pasa la estructura a NdisMRegisterInterruptEx.