OID_GEN_LINK_PARAMETERS
Come set, i driver NDIS e overlying usano l'OID OID_GEN_LINK_PARAMETERS per impostare lo stato di collegamento corrente di un adattatore miniport. Il driver miniport riceve lo stato duplex, la velocità di collegamento e le funzioni di sospensione in una struttura NDIS_LINK_PARAMETERS.
Informazioni sulla versione
Windows Vista e versioni successive di Windows
Supportata.
Driver miniport NDIS 6.0 e versioni successive
Facoltativa.
La struttura NDIS_LINK_PARAMETERS è definita come segue:
typedef struct _NDIS_LINK_PARAMETERS {
NDIS_OBJECT_HEADER Header;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
ULONG AutoNegotiationFlags;
} NDIS_LINK_PARAMETERS, *PNDIS_LINK_PARAMETERS;
Questa struttura contiene i membri seguenti:
Intestazione
Struttura NDIS_OBJECT_HEADER per la struttura NDIS_LINK_PARAMETERS. Impostare il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NDIS_LINK_PARAMETERS_REVISION_1 e il membro Size su NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.
MediaDuplexState
Stato duplex del supporto. Questo valore corrisponde al valore restituito dall'OID OID_GEN_MEDIA_DUPLEX_STATE .
XmitLinkSpeed
Velocità del collegamento di trasmissione in bit al secondo.
RcvLinkSpeed
Velocità del collegamento di ricezione in bit al secondo.
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 o il partner di collegamento non supporta i frame di sospensione.
NdisPauseFunctionsSendOnly
L'adapter e il partner di collegamento supportano solo l'invio di frame di sospensione dall'adattatore al partner di collegamento.
NdisPauseFunctionsReceiveOnly
L'adapter e il partner di collegamento supportano solo l'invio di frame di sospensione dal partner di collegamento all'adapter
NdisPauseFunctionsSendAndReceive
L'adattatore e il partner di collegamento supportano l'invio e la ricezione di fotogrammi di sospensione in istruzioni di trasmissione e ricezione.
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 deve negoziare automaticamente la velocità del collegamento di trasmissione con il partner di collegamento. Se questo flag non è impostato, il driver miniport deve impostare la velocità del collegamento di trasmissione sul valore specificato nel membro XmitLinkSpeed .
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
L'adattatore deve negoziare automaticamente la velocità del collegamento di ricezione con il partner di collegamento. Se questo flag non è impostato, il driver miniport deve impostare la velocità di collegamento di ricezione sul valore specificato nel membro RcvLinkSpeed .
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
L'adattatore deve negoziare automaticamente lo stato duplex con il partner di collegamento. Se questo flag non è impostato, il driver miniport deve impostare lo stato duplex sul valore specificato nel membro MediaDuplexState .
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
Il driver miniport deve negoziare automaticamente il supporto per i fotogrammi di sospensione con l'altra estremità. Se questo flag non è impostato, il driver miniport deve usare il supporto del frame di sospensione specificato nel membro PauseFunctions .
Commenti
Nota L'impostazione di OID_GEN_LINK_PARAMETERS può causare una perdita di connettività. I driver miniport devono riconfigurare l'adattatore miniport quando questo OID è impostato. Ad esempio, il driver miniport può reimpostare l'adattatore miniport con la conseguente perdita di connessioni esistenti. Il meccanismo specifico per la riconfigurazione dipende dall'applicazione.
Se lo stato del collegamento dell'adattatore miniport cambia a causa della richiesta impostata di OID_GEN_LINK_PARAMETERS, il driver miniport deve generare un'indicazione di stato NDIS_STATUS_LINK_STATE per notificare NDIS e driver eccessivamente driver del nuovo stato del collegamento.
Requisiti
Intestazione |
Ntddndis.h (include Ndis.h) |