struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (ndis.h)

Articolo
04/13/2023

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES . Impostare il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

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

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

Aggiunta del membro PowerManagementCapabilitiesEx per NDIS 6.2.

Impostare il membro Sizesu 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 Sizesu 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 di supporto 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 ulteriori 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 dei pacchetti per l'adattatore miniport.

MaxMulticastListSize

Dimensioni dell'elenco di indirizzi multicast per l'adattatore miniport. Per ulteriori 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à rss (Receive Side Scaling) 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 all'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 di 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 un adattatore fisico.

SupportedStatistics

Statistiche supportate.

Nota I 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 membro ifHCInUcastPkts sono validi.

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

I dati nel membro ifHCInMulticastPkts di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

I dati nel membro ifHCInBroadcastPkts di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

I dati nel membro ifHCInOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

I dati nel membro ifInDiscards di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

I dati nel membro ifInErrors di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

I dati nel membro ifHCOutUcastPkts di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

I dati nel membro ifHCOutMulticastPkts di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

I dati nel membro ifHCOutBroadcastPkts di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

I dati nel membro ifHCOutOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

I dati nel membro ifOutErrors di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

I dati nel membro ifOutDiscards di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

I dati nel membro ifHCInUcastOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

I dati nel membro ifHCInMulticastOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

I dati nel membro ifHCInBroadcastOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

I dati nel membro ifHCOutUcastOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

I dati nel membro ifHCOutMulticastOctets di NDIS_STATISTICS_INFO sono validi.

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

I dati nel membro ifHCOutBroadcastOctets di NDIS_STATISTICS_INFO sono validi.

SupportedPauseFunctions

Supporto per i frame 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'adattatore e il partner di collegamento supportano solo l'invio di frame di sospensione dalla scheda al partner di collegamento.

NdisPauseFunctionsReceiveOnly

Indica che l'adapter e il partner di collegamento supportano solo l'invio di frame di sospensione dal partner di collegamento alla scheda

NdisPauseFunctionsSendAndReceive

Indica che l'adattatore e il partner di collegamento supportano l'invio e la ricezione di fotogrammi di sospensione sia nella trasint che nelle direzioni di ricezione.

NdisPauseFunctionsUnknown

Indica che la negoziazione del 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 necessarie, 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à di collegamento di trasmissione con il partner di collegamento.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

L'adattatore ha negoziato automaticamente la velocità di 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'adapter 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 dell'adattatore miniport. Questo membro è obbligatorio per i driver NDIS 6.20 e versioni successive.

Commenti

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