NDIS_MINIPORT_SS_CHARACTERISTICS-Struktur (ndis.h)

Artikel
03/05/2024

Die NDIS_MINIPORT_SS_CHARACTERISTICS-Struktur gibt die Zeiger auf die selektiven NDIS-Handlerfunktionen eines Miniporttreibers an. Diese Funktionen werden von NDIS aufgerufen, um während eines selektiven Anhaltens Benachrichtigungen im Leerlauf an den Treiber auszusetzen.

Syntax

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;

Member

Header

Der Typ, die Revision und die Größe der NDIS_MINIPORT_SS_CHARACTERISTICS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS festlegen. Um die Version der NDIS_MINIPORT_SS_CHARACTERISTICS-Struktur anzugeben, muss der Treiber das Revisionselement des Headers auf den folgenden Wert festlegen:

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1 fest.

Flags

Ein ULONG-Wert , der ein bitweises OR von Flags enthält. Dieses Element ist für NDIS reserviert.

IdleNotificationHandler

Ein Zeiger auf die MiniportIdleNotification-Funktion des Miniporttreibers .

CancelIdleNotificationHandler

Ein Zeiger auf die MiniportCancelIdleNotification-Funktion des Miniporttreibers .

Hinweise

Um die Handlerfunktionen für das selektive Anhalten von NDIS zu registrieren, führt der Miniporttreiber die folgenden Schritte aus, wenn seine MiniportSetOptions-Funktion aufgerufen wird:

Der Miniporttreiber initialisiert eine NDIS_MINIPORT_SS_CHARACTERISTICS-Struktur mit Zeigern auf die Handlerfunktionen.
Der Miniporttreiber ruft dann NdisSetOptionalHandlers auf und legt den OptionalHandlers-Parameter auf einen Zeiger auf die NDIS_MINIPORT_SS_CHARACTERISTICS-Struktur fest.

Weitere Informationen zum Behandeln von Benachrichtigungen im Leerlauf für das selektive Anhalten von NDIS finden Sie unter NDIS Selective Suspend-Benachrichtigungen im Leerlauf.