OID_GEN_LINK_PARAMETERS
Als set gebruiken NDIS en bovenliggende stuurprogramma's de OID_GEN_LINK_PARAMETERS OID om de huidige koppelingsstatus van een minipoortadapter in te stellen. Het minipoortstuurprogramma ontvangt de duplexstatus, de koppelingssnelheden en pauzefuncties in een NDIS_LINK_PARAMETERS structuur.
versie-informatie
Windows Vista en latere versies van Windows
Ondersteund.
NDIS 6.0 en hoger minipoortstuurprogramma's
Facultatief.
De NDIS_LINK_PARAMETERS structuur wordt als volgt gedefinieerd:
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;
Deze structuur bevat de volgende leden:
koptekst
De NDIS_OBJECT_HEADER structuur voor de NDIS_LINK_PARAMETERS structuur. Stel het type lid in van de structuur die koptekst opgeeft voor NDIS_OBJECT_TYPE_DEFAULT, het revisielid op NDIS_LINK_PARAMETERS_REVISION_1 en het grootte lid op NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.
MediaDuplexState
De dubbelzijdige mediastatus. Deze waarde is hetzelfde als de waarde die wordt geretourneerd door de OID_GEN_MEDIA_DUPLEX_STATE OID.
XmitLinkSpeed-
De snelheid van de overdrachtskoppeling in bits per seconde.
RcvLinkSpeed-
De snelheid van de ontvangstkoppeling in bits per seconde.
PauseFunctions-
Het type ondersteuning voor de IEEE 802.3-pauzeframes. Dit lid moet een van de volgende pauzefuncties zijn:
NdisPauseFunctionsUnsupported
De adapter of koppelingspartner biedt geen ondersteuning voor onderbrekingsframes.
NdisPauseFunctionsSendOnly-
De adapter en koppelingspartner ondersteunen alleen het verzenden van onderbrekingsframes van de adapter naar de koppelingspartner.
NdisPauseFunctionsReceiveOnly
De adapter en koppelingspartner ondersteunen alleen het verzenden van onderbrekingsframes van de koppelingspartner naar de adapter
NdisPauseFunctionsSendAndReceive-
De adapter en koppelingspartner ondersteunen het verzenden en ontvangen van onderbrekingsframes in zowel verzenden als ontvangen routebeschrijvingen.
AutoNegotiationFlags
De instellingen voor automatische onderhandeling voor de minipoortadapter. Dit lid wordt gemaakt op basis van een bitsgewijze OF van de volgende vlaggen:
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
De adapter moet automatisch onderhandelen over de snelheid van de overdrachtskoppeling met de koppelingspartner. Als deze vlag niet is ingesteld, moet het minipoortstuurprogramma de snelheid van de overdrachtskoppeling instellen op de waarde die is opgegeven in de XmitLinkSpeed lid.
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
De adapter moet automatisch onderhandelen over de snelheid van de ontvangstkoppeling met de koppelingspartner. Als deze vlag niet is ingesteld, moet het minipoortstuurprogramma de snelheid van de ontvangstkoppeling instellen op de waarde die is opgegeven in de RcvLinkSpeed lid.
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
De adapter moet automatisch onderhandelen over de duplexstatus met de koppelingspartner. Als deze vlag niet is ingesteld, moet het minipoortstuurprogramma de duplexstatus instellen op de waarde die is opgegeven in de MediaDuplexState lid.
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
Het minipoortstuurprogramma moet automatisch onderhandelen over de ondersteuning voor onderbrekingsframes met het andere uiteinde. Als deze vlag niet is ingesteld, moet het minipoortstuurprogramma de ondersteuning voor het pauzeframe gebruiken dat is opgegeven in de PauseFunctions lid.
Opmerkingen
Opmerking Instelling OID_GEN_LINK_PARAMETERS kan leiden tot een verlies van connectiviteit. Minipoortstuurprogramma's moeten de minipoortadapter opnieuw configureren wanneer deze OID is ingesteld. Het minipoortstuurprogramma kan bijvoorbeeld de minipoortadapter opnieuw instellen met het resulterende verlies van bestaande verbindingen. Het specifieke mechanisme voor herconfiguratie is afhankelijk van de toepassing.
Als de koppelingsstatus van de minipoortadapter verandert vanwege de OID_GEN_LINK_PARAMETERS ingestelde aanvraag, moet het minipoortstuurprogramma een NDIS_STATUS_LINK_STATE statusindicatie genereren om NDIS op de hoogte te stellen en stuurprogramma's van de nieuwe koppelingsstatus te laten liggen.
Eisen
Rubriek |
Ntddndis.h (inclusief Ndis.h) |