Compartilhar via


NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG

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

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

Comentários

Durante a inicialização, o driver de miniporte 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 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 NDIS_TIMESTAMP_CAPABILITY_FLAGS deverá ser definido como TRUE se o recurso de carimbo de data/hora correspondente estiver habilitado no momento ou FALSE se não estiver.

    Observação

    Para determinar quais recursos de carimbo de data/hora estão atualmente habilitados ou desabilitados, 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 de pacote NDIS.

    Observação

    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 como TRUE se os carimbos de data/hora entre 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 Cabeçalho deve ser definido como NDIS_OBJECT_TYPE_DEFAULT e a Revisão para NDIS_TIMESTAMP_CAPABILITIES_REVISION_1.

  2. Gere uma indicação de NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status 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 miniporte 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á o NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status indicação e não será indicado para drivers excessivamente.

Se o driver de miniporto indicar uma alteração no recurso de carimbo de data/hora de hardware da NIC usando o NDIS_STATUS_TIMESTAMP_CAPABILITY status indicação (por exemplo, uma alteração no campo HardwareClockFrequencyHz 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 status.

O driver de miniporte também deve gerar o NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status indicação 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)

Confira também

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

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

NDIS_STATUS_TIMESTAMP_CAPABILITY

NDIS_TIMESTAMP_CAPABILITIES

NDIS_TIMESTAMP_CAPABILITY_FLAGS

MiniportInitializeEx

NdisMIndicateStatusEx

NDIS_STATUS_INDICATION