estrutura NDIS_MINIPORT_SS_CHARACTERISTICS (ndis.h)

Artigo
02/26/2024

A estrutura NDIS_MINIPORT_SS_CHARACTERISTICS especifica os ponteiros para as funções de manipulador de suspensão seletiva do NDIS de um driver de miniport. 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 miniporte deve definir o membro Tipo de Cabeçalho como NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS. Para especificar a versão da estrutura NDIS_MINIPORT_SS_CHARACTERISTICS , o driver deve definir o membro Revision de Header para o seguinte valor:

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1.

Flags

Um valor ULONG que contém um OR bit a bit de sinalizadores. Esse membro é reservado para o 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.

Comentários

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 miniporta inicializa uma estrutura 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 a suspensão seletiva do NDIS, consulte Notificações ociosas de suspensão seletiva do NDIS.