struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (ndis.h)

Articolo
02/07/2025

Un driver miniport NDIS configura una struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES per definire gli attributi generali del driver miniport associati a un adattatore miniport.

Sintassi

typedef struct _NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES {
  NDIS_OBJECT_HEADER               Header;
  ULONG                            Flags;
  NDIS_MEDIUM                      MediaType;
  NDIS_PHYSICAL_MEDIUM             PhysicalMediumType;
  ULONG                            MtuSize;
  ULONG64                          MaxXmitLinkSpeed;
  ULONG64                          XmitLinkSpeed;
  ULONG64                          MaxRcvLinkSpeed;
  ULONG64                          RcvLinkSpeed;
  NDIS_MEDIA_CONNECT_STATE         MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE          MediaDuplexState;
  ULONG                            LookaheadSize;
  PNDIS_PNP_CAPABILITIES           PowerManagementCapabilities;
  ULONG                            MacOptions;
  ULONG                            SupportedPacketFilters;
  ULONG                            MaxMulticastListSize;
  USHORT                           MacAddressLength;
  UCHAR                            PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                            CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  PNDIS_RECEIVE_SCALE_CAPABILITIES RecvScaleCapabilities;
  NET_IF_ACCESS_TYPE               AccessType;
  NET_IF_DIRECTION_TYPE            DirectionType;
  NET_IF_CONNECTION_TYPE           ConnectionType;
  NET_IFTYPE                       IfType;
  BOOLEAN                          IfConnectorPresent;
  ULONG                            SupportedStatistics;
  ULONG                            SupportedPauseFunctions;
  ULONG                            DataBackFillSize;
  ULONG                            ContextBackFillSize;
  PNDIS_OID                        SupportedOidList;
  ULONG                            SupportedOidListLength;
  ULONG                            AutoNegotiationFlags;
  PNDIS_PM_CAPABILITIES            PowerManagementCapabilitiesEx;
} NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES;

Membri

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES. Impostare il membro Type della struttura che Header specifica su NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

Per indicare la versione della struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, impostare il membro revisione su uno dei valori seguenti:

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

Aggiunta del membro PowerManagementCapabilitiesEx per NDIS 6.2.

Impostare il membro Dimensioni su NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

Versione originale per NDIS 6.0 e NDIS 6,1.

Impostare il membro Dimensioni su NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1.

Flags

Riservato per NDIS.

MediaType

Tipo NdisMediumXxx supportato dall'adattatore miniport. Per altre informazioni, vedere NDIS_MEDIUM.

PhysicalMediumType

Tipo medio fisico per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_PHYSICAL_MEDIUM

MtuSize

Dimensione massima dell'unità di trasferimento (MTU). Per altre informazioni, vedere OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Velocità massima del collegamento di trasmissione dell'adattatore in bit al secondo. Per altre informazioni, vedere OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

Velocità del collegamento di trasmissione corrente dell'adattatore in bit al secondo. Per altre informazioni, vedere OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

Velocità massima del collegamento di ricezione dell'adattatore in bit al secondo. Per altre informazioni, vedere OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

Velocità del collegamento di ricezione corrente dell'adattatore in bit al secondo. Per altre informazioni, vedere OID_GEN_LINK_SPEED_EX.

MediaConnectState

Stato di connessione multimediale per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

Stato duplex multimediale per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_MEDIA_DUPLEX_STATE.

LookaheadSize

Dimensioni lookahead per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Funzionalità Plug and Play (PnP) dell'adattatore miniport. Per altre informazioni sulle funzionalità PnP, vedere OID_PNP_CAPABILITIES. Se l'adattatore miniport non è compatibile con il risparmio energia, il driver miniport deve impostare PowerManagementCapabilities su NULL. I driver NDIS 6.20 e versioni successive devono usare invece il membro PowerManagementCapabilitiesEx.

MacOptions

Opzioni MAC per l'adattatore miniport. Per altre informazioni, vedere OID_GEN_MAC_OPTIONS.

SupportedPacketFilters

Flag di filtro pacchetti per l'adattatore miniport.

MaxMulticastListSize

Dimensioni dell'elenco di indirizzi multicast per l'adattatore miniport. Per altre informazioni, vedere OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

Lunghezza dell'indirizzo MAC, in byte. La lunghezza dell'indirizzo MAC è specifica per il tipo di supporto.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC permanente. Ad esempio, l'OID OID_802_3_PERMANENT_ADDRESS specifica l'indirizzo MAC permanente per i driver IEEE 802.3.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Indirizzo MAC corrente. Ad esempio, l'OID OID_802_3_CURRENT_ADDRESS specifica l'indirizzo MAC corrente per i driver IEEE 802.3.

RecvScaleCapabilities

Funzionalità di ridimensionamento lato ricezione (RSS) della scheda di interfaccia di rete. Se l'adattatore miniport non supporta la funzionalità RSS, impostare RecvScaleCapabilities su NULL. Per altre informazioni su RSS, vedere OID_GEN_RECEIVE_SCALE_CAPABILITIES.

AccessType

Tipo di accesso dell'interfaccia di rete NDIS NET_IF_ACCESS_TYPE.

DirectionType

Tipo di direzione dell'interfaccia di rete NDIS NET_IF_DIRECTION_TYPE.

ConnectionType

Tipo di connessione dell'interfaccia di rete NDIS NET_IF_CONNECTION_TYPE.

IfType

Tipo di interfaccia IANA (Internet Assigned Numbers Authority). Ad esempio, IF_TYPE_ETHERNET_CSMACD (6) è il valore per IfType assegnato a qualsiasi interfaccia simile a Ethernet. Per un elenco se i tipi di interfaccia, vedere tipi di interfaccia NDIS.

IfConnectorPresent

Valore booleano che indica se è presente un connettore. Impostare questo valore su TRUE se è presente una scheda fisica.

SupportedStatistics

Statistiche supportate.

Nota driver NDIS 6.0 devono supportare tutte le statistiche e devono segnalarle quando i driver vengono sottoposti a query per OID_GEN_STATISTICS.

Il valore è l'OR bit per bit dei flag seguenti:

NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED

I dati nel seHCInUcastPkts membro è valido.

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

I dati nel ifHCInMulticastPkts membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

I dati nel ifHCInBroadcastPkts membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

I dati nel ifHCInOctets membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

I dati nel ifInDiscards membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

I dati nel ifInErrors membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

I dati nel ifHCOutUcastPkts membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

I dati nel ifHCOutMulticastPkts membro di NDIS_STATISTICS_INFO è valido.

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

I dati nel ifHCOutBroadcastPkts membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

I dati nel ifHCOutOctets membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

I dati nel ifOutErrors membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

I dati nel ifOutDiscards membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

I dati nel ifHCInUcastOctets membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

I dati nel ifHCInMulticastOctets membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

I dati nel ifHCInBroadcastOctets membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

I dati nel ifHCOutUcastOctets membro di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

I dati nel ifHCOutMulticastOctets membro di NDIS_STATISTICS_INFO è valido.

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

I dati nel ifHCOutBroadcastOctets membro di NDIS_STATISTICS_INFO sono validi.

SupportedPauseFunctions

Supporto per i fotogrammi di sospensione IEEE 802.3 come una delle funzioni di sospensione seguenti:

NdisPauseFunctionsUnsupported

Indica che l'adattatore o il partner di collegamento non supporta i frame di sospensione.

NdisPauseFunctionsSendOnly

Indica che l'adapter e il partner di collegamento supportano solo l'invio di frame di sospensione dall'adapter al partner di collegamento.

NdisPauseFunctionsReceiveOnly

Indica che l'adattatore e il partner di collegamento supportano solo l'invio di frame di sospensione dal partner di collegamento all'adattatore

NdisPauseFunctionsSendAndReceive

Indica che l'adattatore e il partner di collegamento supportano l'invio e la ricezione di fotogrammi di sospensione sia in direzione transint che di ricezione.

NdisPauseFunctionsUnknown

Indica che la negoziazione frame di sospensione è in corso. Il supporto del frame di sospensione fornito dal partner di collegamento è sconosciuto.

DataBackFillSize

Dimensioni del riempimento dei dati necessarie, in byte, del driver.

ContextBackFillSize

Dimensioni del riempimento del contesto richieste, in byte, del driver.

SupportedOidList

Elenco di ID supportati dal driver miniport. Per altre informazioni, vedere OID_GEN_SUPPORTED_LIST.

SupportedOidListLength

Dimensioni, in byte, dell'elenco OID in SupportedOidList .

AutoNegotiationFlags

Impostazioni di negoziazione automatica per l'adattatore miniport. Questo membro viene creato da un OR bit per bit dei flag seguenti:

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

L'adattatore ha negoziato automaticamente la velocità del collegamento di trasmissione con il partner di collegamento.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

L'adattatore ha negoziato automaticamente la velocità del collegamento di ricezione con il partner di collegamento.

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

L'adattatore ha negoziato automaticamente lo stato duplex con il partner di collegamento.

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

L'adattatore ha negoziato automaticamente le funzioni di sospensione con il partner di collegamento.

PowerManagementCapabilitiesEx

Puntatore a una struttura NDIS_PM_CAPABILITIES. Questa struttura specifica le funzionalità di risparmio energia della scheda miniport. Questo membro è obbligatorio per i driver NDIS 6.20 e versioni successive.

Osservazioni

Un driver miniport passa un puntatore a una struttura di NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES nel parametro MiniportAttributes funzione NdisMSetMiniportAttributes. Un driver miniport chiama NdisMSetMiniportAttributes dalla relativa funzione MiniportInitializeEx durante l'inizializzazione. I driver Miniport devono impostare questi attributi dopo aver impostato gli attributi di registrazione in NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES struttura e prima di impostare qualsiasi altro attributo. L'impostazione di questo attributo è obbligatoria.