NDIS_MINIPORT_SS_CHARACTERISTICS structure (ndis.h)

Article
02/26/2024

La structure NDIS_MINIPORT_SS_CHARACTERISTICS spécifie les pointeurs vers les fonctions de gestionnaire de suspension sélective NDIS d’un pilote miniport. Ces fonctions sont appelées par NDIS pour émettre des notifications d’inactivité au pilote pendant une opération de suspension sélective.

Syntaxe

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;

Membres

Header

Type, révision et taille de la structure NDIS_MINIPORT_SS_CHARACTERISTICS . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS. Pour spécifier la version de la structure NDIS_MINIPORT_SS_CHARACTERISTICS , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Taille sur NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

IdleNotificationHandler

Pointeur vers la fonction MiniportIdleNotification du pilote miniport .

CancelIdleNotificationHandler

Pointeur vers la fonction MiniportCancelIdleNotification du pilote miniport .

Remarques

Pour inscrire les fonctions de gestionnaire pour la suspension sélective NDIS, le pilote miniport suit les étapes suivantes lorsque sa fonction MiniportSetOptions est appelée :

Le pilote miniport initialise une structure NDIS_MINIPORT_SS_CHARACTERISTICS avec des pointeurs vers les fonctions de gestionnaire.
Le pilote miniport appelle ensuite NdisSetOptionalHandlers et définit le paramètre OptionalHandlers sur un pointeur vers la structure NDIS_MINIPORT_SS_CHARACTERISTICS .

Pour plus d’informations sur la gestion des notifications inactives pour la suspension sélective NDIS, consultez Notifications d’inactivité de suspension sélective NDIS.