Partilhar via


OID_GEN_CO_GET_NETCARD_TIME

Observação

OID_GEN_CO_GET_NETCARD_TIME é o mesmo que OID_GEN_GET_NETCARD_TIME.

O OID_GEN_CO_GET_NETCARD_TIME OID solicita que o driver de miniporta retorne a hora local de uma NIC, conforme derivado de um relógio na NIC ou da rede. A hora é formatada como uma estrutura GEN_GET_NETCARD_TIME, definida da seguinte forma:

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

O membro desta estrutura contém as seguintes informações:

ReadTime
Hora local do NIC.

Comentários

O driver de miniporta especificou as unidades para sua hora local no elemento ClockPrecision da estrutura de GEN_GET_TIME_CAPS que o driver de miniporta retornou em resposta a uma consulta OID_GEN_CO_GET_TIME_CAPS anterior.

Se o driver de miniporta definir o sinalizador de READABLE_LOCAL_CLOCK em sua resposta a uma consulta OID_GEN_CO_GET_TIME_CAPS, a NIC derivará sua hora local de um relógio integrado. Se o driver de miniporta definir o sinalizador de CLOCK_NETWORK_DERIVED em sua resposta a uma consulta OID_GEN_CO_GET_TIME_CAPS, a NIC derivará sua hora local da rede.

Se a hora local for derivada de um relógio de bordo, o driver da miniporta deve ser capaz de relatar a precisão do relógio em partes por milhão. Em geral, um relógio derivado da rede é preferível, porque é provável que seja mais preciso e pode ser usado para sincronizar muitas máquinas conectadas à mesma rede ou switch.

O driver de miniporta deve retornar sua hora local de forma síncrona em sua resposta à consulta OID_GEN_CO_GET_NETCARD_TIME, uma vez que essa consulta sincroniza os drivers de protocolo com a hora local da NIC. Os drivers de protocolo devem enviar a consulta OID_GEN_CO_GET_NETCARD_TIME várias vezes consecutivas para filtrar as latências de tempo de resposta.

Requerimentos

Versão: Windows Vista e posterior de cabeçalho : Ntddndis.h (incluir Ndis.h)