Dela via


OID_GEN_LINK_PARAMETERS

Som en uppsättning använder NDIS- och överförbrukningsdrivrutiner OID_GEN_LINK_PARAMETERS OID för att ange det aktuella länktillståndet för ett miniportkort. Miniportdrivrutinen tar emot duplextillstånd, länkhastigheter och pausfunktioner i en NDIS_LINK_PARAMETERS struktur.

versionsinformation

Windows Vista och senare versioner av Windows
Stödd.

NDIS 6.0 och senare miniportdrivrutiner
Valfri.

Den NDIS_LINK_PARAMETERS strukturen definieras på följande sätt:

    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;

Den här strukturen innehåller följande medlemmar:

Rubrik
Den NDIS_OBJECT_HEADER strukturen för den NDIS_LINK_PARAMETERS strukturen. Ange typ medlem i strukturen som rubrik anger till NDIS_OBJECT_TYPE_DEFAULT, Revision medlem till NDIS_LINK_PARAMETERS_REVISION_1 och storlek medlem till NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.

MediaDuplexState
Mediets duplextillstånd. Det här värdet är samma som värdet som returneras av OID_GEN_MEDIA_DUPLEX_STATE OID.

XmitLinkSpeed
Överföringslänkhastigheten i bitar per sekund.

RcvLinkSpeed
Hastigheten för mottagningslänken i bitar per sekund.

PauseFunctions
Typ av stöd för pausbildrutorna i IEEE 802.3. Den här medlemmen måste vara en av följande pausfunktioner:

NdisPauseFunctionsUnsupported
Adaptern eller länkpartnern stöder inte pausa bildrutor.

NdisPauseFunctionsSendOnly
Adaptern och länkpartnern har endast stöd för att skicka pausramar från adaptern till länkpartnern.

NdisPauseFunctionsReceiveOnly
Adaptern och länkpartnern har endast stöd för att skicka pausramar från länkpartnern till adaptern

NdisPauseFunctionsSendAndReceive
Adaptern och länkpartnern stöder sändning och mottagning av pausramar i både överförings- och mottagningsriktningar.

AutoNegotiationFlags
Inställningarna för automatisk förhandling för miniportkortet. Den här medlemmen skapas från en bitvis ELLER av följande flaggor:

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
Adaptern ska förhandla om överföringshastigheten automatiskt med länkpartnern. Om den här flaggan inte har angetts ska miniportdrivrutinen ange överföringslänkhastigheten till det värde som anges i XmitLinkSpeed medlem.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
Adaptern ska förhandla om mottagningslänkhastigheten automatiskt med länkpartnern. Om den här flaggan inte har angetts ska miniportdrivrutinen ange hastigheten för mottagningslänken till det värde som anges i RcvLinkSpeed medlem.

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
Adaptern ska förhandla om duplextillståndet automatiskt med länkpartnern. Om den här flaggan inte har angetts ska miniportdrivrutinen ange duplextillståndet till det värde som anges i MediaDuplexState medlem.

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
Miniportdrivrutinen bör förhandla om stödet för pausa ramar automatiskt med den andra änden. Om den här flaggan inte har angetts bör miniportdrivrutinen använda stöd för pausramen som anges i PauseFunctions medlem.

Anmärkningar

Observera inställning OID_GEN_LINK_PARAMETERS kan orsaka förlust av anslutningar. Miniportdrivrutiner måste konfigurera om miniportadaptern när den här OID:en har angetts. Miniportdrivrutinen kan till exempel återställa miniportkortet med den resulterande förlusten av befintliga anslutningar. Den specifika mekanismen för omkonfiguration är programberoende.

Om länktillståndet för miniportkortet ändras på grund av den OID_GEN_LINK_PARAMETERS angivna begäran bör miniportdrivrutinen generera en NDIS_STATUS_LINK_STATE statusindikering för att meddela NDIS och överdrivande drivrutiner om det nya länktillståndet.

Krav

Rubrik

Ntddndis.h (inkludera Ndis.h)

Se även

NDIS_OBJECT_HEADER

NDIS_STATUS_LINK_STATE

OID_GEN_MEDIA_DUPLEX_STATE