estrutura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Artigo
08/07/2023

A estrutura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX define informações específicas da mídia associadas a uma estrutura NET_BUFFER_LIST .

Sintaxe

typedef struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX {
  NDIS_OBJECT_HEADER                             Header;
  struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX *NextEntry;
  ULONG                                          Tag;
  PVOID                                          Data;
} NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX, *PNDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). O driver define o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision para NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 e o membro Size para NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1.

NextEntry

Um ponteiro para a próxima estrutura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX em uma lista vinculada de estruturas de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX. Se essa for a última estrutura na lista, o ponteiro será NULL. Os drivers devem usar o NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX e NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros para manipular essa lista.

Tag

Um valor exclusivo (atribuído pela Microsoft) que identifica o tipo de informações específicas da mídia. Esse membro é reservado para uso do sistema.

Novas marcas podem ser atribuídas em versões futuras do sistema para novos tipos de mídia que exigem dados OOB adicionais específicos para um tipo de mídia específico.

Data

Um ponteiro para um buffer que contém as informações específicas da mídia.

Comentários

Os drivers NDIS 6.20 e posteriores devem usar a estrutura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX para especificar informações específicas da mídia. Qualquer driver em uma pilha de driver NDIS pode alocar e gerenciar informações específicas da mídia. As informações específicas da mídia são especificadas em uma lista vinculada terminada em NULL de estruturas de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX e cada estrutura contém dados alocados por driver e definidos pelo driver.

As estruturas na lista contêm dados OOB (fora de banda) específicos da mídia que acompanham as estruturas de NET_BUFFER associadas a uma estrutura NET_BUFFER_LIST .

Se um driver de protocolo alocou os dados OOB, ele configurou os dados para uma operação de envio. Se um driver de miniporta alocar os dados, ele configurou os dados para uma indicação de recebimento.

Para obter o primeiro elemento na lista vinculada, um driver NDIS chama a macro NET_BUFFER_LIST_INFO e especifica o tipo de informação MediaSpecificInformationEx .

Para adicionar, obter e remover estruturas NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX na lista vinculada, use o NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX e NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros.