OID_GEN_LINK_PARAMETERS
En tant qu’ensemble, les pilotes NDIS et overlying utilisent l’OID OID_GEN_LINK_PARAMETERS pour définir l’état de liaison actuel d’un adaptateur miniport. Le pilote miniport reçoit l’état duplex, les vitesses de liaison et les fonctions de pause dans une structure de NDIS_LINK_PARAMETERS.
Informations sur la version
Windows Vista et versions ultérieures de Windows
Pris en charge.
Pilotes miniport NDIS 6.0 et ultérieur
Optionnel.
La structure NDIS_LINK_PARAMETERS est définie comme suit :
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;
Cette structure contient les membres suivants :
En-tête
Structure NDIS_OBJECT_HEADER de la structure NDIS_LINK_PARAMETERS. Définissez le membre Type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_LINK_PARAMETERS_REVISION_1 et le membre Size sur NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.
MediaDuplexState
État duplex du média. Cette valeur est identique à la valeur retournée par l’OID OID_GEN_MEDIA_DUPLEX_STATE .
XmitLinkSpeed
Vitesse de la liaison de transmission en bits par seconde.
RcvLinkSpeed
Vitesse de la liaison de réception en bits par seconde.
PauseFunctions
Type de prise en charge des images de pause IEEE 802.3. Ce membre doit être l’une des fonctions de pause suivantes :
NdisPauseFunctionsUnsupported
L’adaptateur ou le partenaire de liaison ne prend pas en charge les images de pause.
NdisPauseFunctionsSendOnly
L’adaptateur et le partenaire de liaison prennent uniquement en charge l’envoi d’images de pause de l’adaptateur au partenaire de liaison.
NdisPauseFunctionsReceiveOnly
L’adaptateur et le partenaire de liaison prennent uniquement en charge l’envoi de trames de pause du partenaire de liaison à l’adaptateur
NdisPauseFunctionsSendAndReceive
L’adaptateur et le partenaire de liaison prennent en charge l’envoi et la réception de trames de pause dans les directions de transmission et de réception.
AutoNegotiationFlags
Paramètres de négociation automatique de l’adaptateur miniport. Ce membre est créé à partir d’un OR au niveau du bit des indicateurs suivants :
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
L’adaptateur doit négocier automatiquement la vitesse de la liaison de transmission avec le partenaire de liaison. Si cet indicateur n’est pas défini, le pilote miniport doit définir la vitesse de liaison de transmission sur la valeur spécifiée dans le membre XmitLinkSpeed .
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
L’adaptateur doit négocier automatiquement la vitesse de la liaison de réception avec le partenaire de liaison. Si cet indicateur n’est pas défini, le pilote miniport doit définir la vitesse de la liaison de réception sur la valeur spécifiée dans le membre RcvLinkSpeed .
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
L’adaptateur doit négocier automatiquement l’état duplex avec le partenaire de liaison. Si cet indicateur n’est pas défini, le pilote miniport doit définir l’état duplex sur la valeur spécifiée dans le membre MediaDuplexState .
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
Le pilote miniport doit négocier automatiquement la prise en charge des images de pause avec l’autre extrémité. Si cet indicateur n’est pas défini, le pilote miniport doit utiliser la prise en charge du frame de pause spécifiée dans le membre PauseFunctions .
Notes
Note La définition de OID_GEN_LINK_PARAMETERS peut entraîner une perte de connectivité. Les pilotes miniport doivent reconfigurer l’adaptateur miniport lorsque cet OID est défini. Par exemple, le pilote miniport peut réinitialiser l’adaptateur miniport avec la perte résultante des connexions existantes. Le mécanisme spécifique de reconfiguration dépend de l’application.
Si l’état de liaison de l’adaptateur miniport change en raison de la demande de définition OID_GEN_LINK_PARAMETERS, le pilote miniport doit générer une indication de status NDIS_STATUS_LINK_STATE pour informer NDIS et les pilotes sur-mentant du nouvel état de liaison.
Spécifications
En-tête |
Ntddndis.h (inclure Ndis.h) |