NDIS_MINIPORT_SS_CHARACTERISTICS estrutura (ndis.h)

Artigo
02/07/2025

A estrutura NDIS_MINIPORT_SS_CHARACTERISTICS especifica os ponteiros para as funções de manipulador de suspensão seletiva do NDIS de um miniportor. Essas funções são chamadas pelo NDIS para emitir notificações ociosas ao driver durante uma operação de suspensão seletiva.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_MINIPORT_SS_CHARACTERISTICS. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O driver de miniporto deve definir o membro tipo do de cabeçalho de como NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS. Para especificar a versão da estrutura de NDIS_MINIPORT_SS_CHARACTERISTICS, o driver deve definir o membro de Revisão do Header com o seguinte valor:

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1.

Flags

Um valor de ULONG que contém um OR bit a bit de sinalizadores. Este membro é reservado para NDIS.

IdleNotificationHandler

Um ponteiro para a função MiniportIdleNotification do driver de miniport.

CancelIdleNotificationHandler

Um ponteiro para a função MiniportCancelIdleNotification do driver de miniport.

Observações

Para registrar as funções de manipulador para suspensão seletiva do NDIS, o driver de miniport segue estas etapas quando sua função MiniportSetOptions é chamada:

O driver de miniporto inicializa uma estrutura de NDIS_MINIPORT_SS_CHARACTERISTICS com ponteiros para as funções do manipulador.
Em seguida, o driver de miniporto chama NdisSetOptionalHandlers e define o parâmetro OptionalHandlers como um ponteiro para a estrutura NDIS_MINIPORT_SS_CHARACTERISTICS.

Para obter mais informações sobre como lidar com notificações ociosas para suspensão seletiva do NDIS, consulte Notificações Ociosas de Suspensão Seletiva do NDIS.