estructura NDIS_MINIPORT_SS_CHARACTERISTICS (ndis.h)

Artículo
03/05/2024

La estructura NDIS_MINIPORT_SS_CHARACTERISTICS especifica los punteros a las funciones de controlador de suspensión selectiva NDIS del controlador de miniporte. NDIS llama a estas funciones para emitir notificaciones inactivas al controlador durante una operación de suspensión selectiva.

Sintaxis

typedef struct _NDIS_MINIPORT_SS_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                        Header;
  ULONG                                     Flags;
  MINIPORT_IDLE_NOTIFICATION_HANDLER        IdleNotificationHandler;
  MINIPORT_CANCEL_IDLE_NOTIFICATION_HANDLER CancelIdleNotificationHandler;
} NDIS_MINIPORT_SS_CHARACTERISTICS, *PNDIS_MINIPORT_SS_CHARACTERISTICS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_MINIPORT_SS_CHARACTERISTICS . Este miembro tiene formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS. Para especificar la versión de la estructura de NDIS_MINIPORT_SS_CHARACTERISTICS , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1.

Flags

Valor de ULONG que contiene un OR bit a bit de marcas. Este miembro está reservado para NDIS.

IdleNotificationHandler

Puntero a la función MiniportIdleNotification del controlador de miniport.

CancelIdleNotificationHandler

Puntero a la función MiniportCancelIdleNotification del controlador de miniport.

Comentarios

Para registrar las funciones de controlador para la suspensión selectiva de NDIS, el controlador de minipuerto sigue estos pasos cuando se llama a su función MiniportSetOptions :

El controlador de minipuerto inicializa una estructura de NDIS_MINIPORT_SS_CHARACTERISTICS con punteros a las funciones del controlador.
A continuación, el controlador de miniporte llama a NdisSetOptionalHandlers y establece el parámetro OptionalHandlers en un puntero a la estructura NDIS_MINIPORT_SS_CHARACTERISTICS .

Para obtener más información sobre cómo controlar las notificaciones inactivas para la suspensión selectiva de NDIS, consulte Notificaciones de suspensión inactiva selectiva de NDIS.