Compartilhar via


NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG

Os drivers de miniporto usam a indicação de status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG para relatar a configuração atual de carimbo de data/hora do driver de hardware e miniporto NIC para NDIS e drivers sobrepostos.

Essa indicação de status representa quais recursos de carimbo de data/hora estão habilitados ou desabilitados no momento. Para obter informações sobre o uso do driver de indicação de status para relatar os recursos de carimbo de data/hora, consulte NDIS_STATUS_TIMESTAMP_CAPABILITY.

Observações

Durante a inicialização, o driver de miniporto deve indicar a configuração de carimbo de data/hora atual de dentro de sua função MiniportInitializeEx. O driver deve:

  1. Inicialize uma estrutura de NDIS_TIMESTAMP_CAPABILITIES com a configuração de carimbo de data/hora atual. O driver define os membros da estrutura NDIS_TIMESTAMP_CAPABILITIES da seguinte maneira:

    • O driver usa o campo TimestampFlags para indicar sua configuração atual de carimbo de data/hora. Cada sinalizador na estrutura de NDIS_TIMESTAMP_CAPABILITY_FLAGS deve ser definido como verdadeiro se o recurso de carimbo de data/hora correspondente estiver habilitado no momento ou FALSE se não estiver.

    Nota

    Para determinar quais recursos de carimbo de data/hora estão habilitados ou desabilitados no momento, o miniporto lê os valores atuais das palavras-chave relacionadas ao carimbo de data/hora *PtpHardwareTimestamp e *SoftwareTimestamp. Para obter mais informações sobre como usar essas palavras-chave e determinar quais recursos de carimbo de data/hora habilitar, consulte palavras-chave INF padronizadas para carimbo de data/hora do pacote NDIS.

    Nota

    Se uma implementação encontrar carimbos de data/hora de hardware e software habilitados por meio das palavras-chave, o miniporto só deverá habilitar carimbos de data/hora de hardware e desabilitar carimbos de data/hora de software.

    • O driver deve definir o campo CrossTimestamp para verdadeiro se os carimbos de data/hora de hardware estiverem habilitados na configuração atual ou FALSE se não estiverem.

    • O campo HardwareClockFrequencyHz deve conter a frequência operacional atual do relógio de hardware da NIC.

    • O campo tipo no campo de Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT e o de Revisão de para NDIS_TIMESTAMP_CAPABILITIES_REVISION_1.

  2. Gere uma indicação de status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG chamando NdisMIndicateStatusEx para relatar a configuração atual. O campo StatusBuffer da estrutura NDIS_STATUS_INDICATION deve apontar para a estrutura de NDIS_TIMESTAMP_CAPABILITIES inicializada.

O driver de miniporto deve gerar uma indicação de NDIS_STATUS_TIMESTAMP_CAPABILITY pelo menos uma vez antes de indicar NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG. Caso contrário, o NDIS rejeitará a indicação de status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG e não será indicada para drivers em excesso.

Se o driver de miniporto indicar uma alteração na funcionalidade de carimbo de data/hora de hardware da NIC usando a indicação de status NDIS_STATUS_TIMESTAMP_CAPABILITY (por exemplo, uma alteração no campo hardwareClockFrequencyHz do na estrutura NDIS_TIMESTAMP_CAPABILITIES devido a uma alteração subjacente no hardware NIC), ele também deverá relatar a alteração correspondente na configuração atual usando o NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG indicação de status.

O driver de miniporto também deve gerar a indicação de status NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG sempre que detectar uma alteração na configuração de carimbo de data/hora atual.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11
Servidor mínimo com suporte Windows Server 2022
Versão do NDIS NDIS 6.82 e posterior
Cabeçalho Ntddndis.h (inclua Ndis.h)

Consulte também

recursos de carimbo de data/hora do Reporting e configuração atual

palavras-chave INF padronizadas para carimbo de data/hora do pacote NDIS

NDIS_STATUS_TIMESTAMP_CAPABILITY

NDIS_TIMESTAMP_CAPABILITIES

NDIS_TIMESTAMP_CAPABILITY_FLAGS

MiniportInitializeEx

NdisMIndicateStatusEx

NDIS_STATUS_INDICATION