struttura NDIS_MINIPORT_SS_CHARACTERISTICS (ndis.h)

Articolo
02/26/2024

La struttura NDIS_MINIPORT_SS_CHARACTERISTICS specifica i puntatori alle funzioni del gestore di sospensione selettiva NDIS di un driver miniport. Queste funzioni vengono chiamate da NDIS per inviare notifiche inattive al driver durante un'operazione di sospensione selettiva.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_MINIPORT_SS_CHARACTERISTICS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare il membro Type di Header su NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS. Per specificare la versione della struttura NDIS_MINIPORT_SS_CHARACTERISTICS , il driver deve impostare il membro Revision di Header sul valore seguente:

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

IdleNotificationHandler

Puntatore alla funzione MiniportIdleNotification del driver miniport .

CancelIdleNotificationHandler

Puntatore alla funzione MiniportCancelIdleNotification del driver miniport .

Commenti

Per registrare le funzioni del gestore per la sospensione selettiva NDIS, il driver miniport segue questi passaggi quando viene chiamata la relativa funzione MiniportSetOptions :

Il driver miniport inizializza una struttura NDIS_MINIPORT_SS_CHARACTERISTICS con puntatori alle funzioni del gestore.
Il driver miniport chiama quindi NdisSetOptionalHandlers e imposta il parametro OptionalHandlers su un puntatore alla struttura NDIS_MINIPORT_SS_CHARACTERISTICS .

Per altre informazioni su come gestire le notifiche di inattività per la sospensione selettiva NDIS, vedere Notifiche di inattività selettiva NDIS.