struttura NDIS_LINK_STATE (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_LINK_STATE specifica lo stato di collegamento corrente di un adattatore miniport.

Sintassi

typedef struct _NDIS_LINK_STATE {
  NDIS_OBJECT_HEADER             Header;
  NDIS_MEDIA_CONNECT_STATE       MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE        MediaDuplexState;
  ULONG64                        XmitLinkSpeed;
  ULONG64                        RcvLinkSpeed;
  NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
  ULONG                          AutoNegotiationFlags;
} NDIS_LINK_STATE, *PNDIS_LINK_STATE;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_LINK_STATE . Impostare il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_DEFAULT, sul membro Revision su NDIS_LINK_STATE_REVISION_1 e sul membro Size su NDIS_SIZEOF_LINK_STATE_REVISION_1.

MediaConnectState

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

MediaDuplexState

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

XmitLinkSpeed

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

Nota Un valore di NDIS_LINK_SPEED_UNKNOWN indica che la velocità del collegamento di trasmissione è sconosciuta.

RcvLinkSpeed

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

Nota Un valore di NDIS_LINK_SPEED_UNKNOWN indica che la velocità del collegamento di ricezione è sconosciuta.

PauseFunctions

Tipo di supporto per i frame di sospensione IEEE 802.3. Questo membro deve essere una delle funzioni di sospensione seguenti:

NdisPauseFunctionsUnsupported

l'adattatore miniport o il partner di collegamento non supporta i fotogrammi di sospensione.

NdisPauseFunctionsSendOnly

l'adattatore miniport e il partner di collegamento supportano solo l'invio di fotogrammi di pausa dall'adattatore miniport al partner di collegamento.

NdisPauseFunctionsReceiveOnly

l'adattatore miniport e il partner di collegamento supportano solo l'invio di fotogrammi di pausa dal partner di collegamento all'adattatore miniport

NdisPauseFunctionsSendAndReceive

l'adattatore miniport e il partner di collegamento supportano l'invio e la ricezione di fotogrammi di sospensione in entrambe le direzioni di trasmissione e ricezione.

NdisPauseFunctionsUnknown

La negoziazione dei fotogrammi di sospensione è in corso. Il supporto del frame di sospensione fornito dal partner di collegamento è sconosciuto.

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 miniport ha negoziato automaticamente la velocità del collegamento di trasmissione con il partner di collegamento.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

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

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

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

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

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

Commenti

I driver Miniport utilizzano l'indicazione di stato NDIS_STATUS_LINK_STATE per notificare NDIS e driver eccessivamente che è stato apportato un cambiamento nelle caratteristiche fisiche di un supporto.

Quando genera questa indicazione di stato, il driver imposta il membro StatusBuffer della struttura NDIS_STATUS_INDICATION su un puntatore a una struttura NDIS_LINK_STATE .

Il driver miniport restituisce anche una struttura NDIS_LINK_STATE quando gestisce una richiesta di query OID di OID_GEN_LINK_STATE.