OID_GEN_CO_GET_NETCARD_TIME

Notes

OID_GEN_CO_GET_NETCARD_TIME est identique à OID_GEN_GET_NETCARD_TIME.

L’OID OID_GEN_CO_GET_NETCARD_TIME demande au pilote miniport de renvoyer l’heure locale d’une carte réseau, comme dérivé d’une horloge sur la carte réseau ou du réseau. L’heure est mise en forme en tant que structure GEN_GET_NETCARD_TIME, définie comme suit :

typedef struct _GEN_GET_NETCARD_TIME{
    ULONGLONG   ReadTime;
} GEN_GET_NETCARD_TIME, *PGEN_GET_NETCARD_TIME;

Le membre de cette structure contient les informations suivantes :

ReadTime
Heure locale de la carte réseau.

Notes

Le pilote miniport a spécifié les unités de son heure locale dans l’élément ClockPrecision de la structure GEN_GET_TIME_CAPS que le pilote miniport a retourné en réponse à une requête OID_GEN_CO_GET_TIME_CAPS précédente.

Si le pilote miniport définit l’indicateur READABLE_LOCAL_CLOCK dans sa réponse à une requête de OID_GEN_CO_GET_TIME_CAPS, la carte réseau dérive son heure locale d’une horloge intégrée. Si le pilote miniport définit l’indicateur CLOCK_NETWORK_DERIVED dans sa réponse à une requête OID_GEN_CO_GET_TIME_CAPS, la carte réseau dérive son heure locale du réseau.

Si l’heure locale est dérivée d’une horloge intégrée, le pilote miniport doit être en mesure de signaler la précision de l’horloge en parties par million. En général, une horloge dérivée du réseau est préférable, car elle est susceptible d’être plus précise et peut être utilisée pour synchroniser de nombreuses machines attachées au même réseau ou commutateur.

Le pilote miniport doit retourner son heure locale de manière synchrone dans sa réponse à la requête OID_GEN_CO_GET_NETCARD_TIME, car cette requête synchronise les pilotes de protocole avec l’heure locale de la carte réseau. Les pilotes de protocole doivent envoyer la requête OID_GEN_CO_GET_NETCARD_TIME plusieurs fois successivement pour filtrer les latences de temps de réponse.

Spécifications

Version : Windows Vista et versions ultérieures En-tête : Ntddndis.h (inclure Ndis.h)