Compartilhar via


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

Um arquivo INF pode definir as seguintes palavras-chave INF padronizadas para habilitar ou desabilitar os recursos de carimbo de data/hora compatíveis com o driver de miniporte e o hardware NIC.

Os drivers de miniport podem usar essas palavras-chave para determinar a configuração atual dos recursos de carimbo de data/hora. Por exemplo, o driver pode ler esses valores palavra-chave durante a inicialização para determinar quais recursos de carimbo de data/hora estão habilitados e, portanto, o driver pode usar.

*PtpHardwareTimestamp INF palavra-chave

*SoftwareTimestamp INF palavra-chave

Para obter mais informações sobre palavras-chave INF padronizadas, consulte Palavras-chave INF padronizadas para dispositivos de rede.

*PtpHardwareTimestamp INF palavra-chave

O palavra-chave *PtpHardwareTimestamp é definido para habilitar ou desabilitar o suporte para carimbo de data/hora de hardware para pacotes ptp versão 2 do Protocolo de Tempo de Precisão usando UDP como transporte.

A configuração padrão para o palavra-chave *PtpHardwareTimestamp está desabilitada e o driver de miniporte deve desabilitar todos os tipos de suporte ao carimbo de data/hora de hardware no hardware NIC por padrão.

Os drivers de miniporte leem o valor de palavra-chave *PtpHardwareTimestamp para determinar se o carimbo de data/hora de hardware está habilitado ou desabilitado no momento.

Se *PtpHardwareTimestamp estiver habilitado, o driver de miniporte deverá:

  1. Habilite os recursos relevantes de carimbo de data/hora de hardware no hardware nic.

  2. Gere o NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status indicação para relatar os recursos de carimbo de data/hora que ele habilitou para o NDIS. O driver usa a estrutura NDIS_TIMESTAMP_CAPABILITIES para especificar quais recursos ele habilitou. Os sinalizadores dentro do campo TimestampFlags na estrutura NDIS_TIMESTAMP_CAPABILITIES que correspondem ao carimbo de data/hora de hardware são PtpV2OverUdpIPv4EventMsgReceiveHw, PtpV2OverUdpIPv4AllMsgReceiveHw, PtpV2OverUdpIPv4EventMsgTransmitHw, PtpV2OverUdpIPv4AllMsgTransmitHw, , PtpV2OverUdpIPv6EventMsgReceiveHw, PtpV2OverUdpIPv6AllMsgReceiveHw, PtpV2OverUdpIPv6EventMsgTransmitHw, PtpV2OverUdpIPv6AllMsgTransmitHw, AllTransmitHwAllReceiveHwe TaggedTransmitHw. O campo CrossTimestamp na estrutura NDIS_TIMESTAMP_CAPABILITIES do NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status indica se o carimbo de data/hora entre hardwares está habilitado.

Quando *PtpHardwareTimestamp estiver habilitado, o miniporto deverá ativar alguma forma de funcionalidade para gerar carimbos de data/hora de hardware para Rx e Tx para PTP versão 2 por UDP. O miniporto também deve ativar a funcionalidade de carimbo de data/hora de hardware se o hardware der suporte a ele.

Os recursos específicos de carimbo de data/hora de hardware que o driver de miniporto deve habilitar no hardware dependem dos recursos do hardware NIC. Por exemplo, se o hardware NIC der suporte apenas aos PtpV2OverUDPIPv4EventMsgReceiveHwrecursos e PtpV2OverUDPIPv6EventMsgReceiveHwTaggedTransmitHw, em seguida, o miniporto poderá ativar esses recursos de carimbo de data/hora de hardware se o palavra-chave *PtpHardwareTimestamp estiver habilitado.

Se o hardware NIC der suporte a várias formas de recursos de carimbo de data/hora de hardware que podem habilitar o PTP versão 2 sobre o cenário UDP, o IHV deverá considerar seu hardware e problemas, como impacto no desempenho, para decidir quais recursos o miniporto deve ativar. Por exemplo, o hardware pode ser capaz de gerar carimbos de data/hora para AllTransmitHw e TaggedTransmitHw. Se ativar AllTransmitHw for mais caro do que ativar TaggedTransmitHw, o IHV poderá optar por ativar apenas a TaggedTransmitHw funcionalidade do Tx.

Em todos os casos, o driver de miniporto deve relatar com precisão quais recursos de carimbo de data/hora de hardware ele habilitou ou desabilitou usando o NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status indicação.

Observação

Não há suporte para PTP sobre Ethernet bruta. O IHV precisa determinar qual é a maneira mais eficiente de lidar com PTP em pacotes Ethernet brutos ao dar suporte a PTP por UDP.

Observação

Nenhum suporte é necessário para o PTP versão 1. Se o hardware NIC também der suporte ao PTP versão 1, o IHV precisará determinar a maneira mais eficiente de lidar com pacotes ptp versão 1 ao dar suporte ao PTP versão 2.

Entradas INF para *PtpHardwareTimestamp

O palavra-chave INF *PtpHardwareTimestamp é uma palavra-chave de enumeração. As palavras-chave INF padronizadas por enumeração têm os seguintes atributos:

SubkeyName: o nome do palavra-chave que você deve especificar no arquivo INF.

ParamDesc: o texto de exibição associado ao SubkeyName.

Valor: o valor inteiro de enumeração associado a cada SubkeyName na lista.

EnumDesc: o texto de exibição associado a cada valor que aparece no menu.

Padrão: o valor padrão para o menu.

A tabela a seguir descreve as possíveis entradas INF para a palavra-chave INF *PtpHardwareTimestamp.

SubkeyName Paramdesc Valor EnumDesc
*PtpHardwareTimestamp Carimbo de data/hora de hardware ptp 0 (padrão) Desabilitado
1 habilitado

Observação

Se o driver de miniporto encontrar um valor sem suporte para o palavra-chave *PtpHardwareTimestamp, ele deverá desabilitar completamente a funcionalidade de carimbo de data/hora de hardware.

*SoftwareTimestamp INF palavra-chave

O palavra-chave *SoftwareTimestamp corresponde aos tipos de carimbo de data/hora de software dos quais o driver de miniporto é capaz. O driver de miniporto usa o valor configurado para esse palavra-chave para determinar quais dos recursos de carimbo de data/hora de software com suporte estão habilitados no momento.

A configuração padrão para o palavra-chave *SoftwareTimestamp está desabilitada e todos os tipos de suporte ao carimbo de data/hora de software no miniporto devem ser desabilitados por padrão.

O miniporto gera a indicação NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status para informar o NDIS sobre os vários recursos de carimbo de data/hora que estão habilitados no momento.

Os sinalizadores dentro do campo TimestampFlags na estrutura NDIS_TIMESTAMP_CAPABILITIES que correspondem ao carimbo de data/hora do software são AllReceiveSw, AllTransmitSw e TaggedTransmitSw.

Se o palavra-chave *SoftwareTimestamp contiver um valor que indica que alguma configuração de carimbo de data/hora de software está habilitada, o miniporto deverá habilitar os recursos de carimbo de data/hora de software configurados e gerar um NDIS_STATUS_TIMESTAMP_CURRENT_CONFIG status indicação de que relata com precisão quais recursos de carimbo de data/hora de software foram habilitados.

Se o miniporto não der suporte a nenhum tipo de carimbo de data/hora de software, a palavra-chave *SoftwareTimestamp não deverá ser incluída em seu arquivo INF.

O palavra-chave INF *SoftwareTimestamp é uma palavra-chave de enumeração. As palavras-chave INF padronizadas por enumeração têm os seguintes atributos:

SubkeyName: o nome do palavra-chave que você deve especificar no arquivo INF.

ParamDesc: o texto de exibição associado ao SubkeyName.

Valor: o valor inteiro de enumeração associado a cada SubkeyName na lista.

EnumDesc: o texto de exibição associado a cada valor que aparece no menu.

Padrão: o valor padrão para o menu.

A tabela a seguir descreve as possíveis entradas INF para o palavra-chave INF *SoftwareTimestamp.

SubkeyName Paramdesc Valor EnumDesc
*SoftwareTimestamp Carimbo de data/hora do software 0 (padrão) Desabilitado
1 RxAll: esse valor de enumeração corresponde à capacidade do driver de miniporto para gerar carimbos de data/hora de software para todos os pacotes durante o Rx.
2 TxAll: esse valor de enumeração corresponde à capacidade do driver de miniporto para gerar carimbos de data/hora de software para todos os pacotes durante o Tx.
3 RxAll & TxAll: esse valor de enumeração corresponde à capacidade do driver de miniporto para gerar carimbos de data/hora de software para todos os pacotes durante Rx e Tx.
4 TaggedTx: esse valor de enumeração corresponde à capacidade do driver de miniporto para gerar carimbos de data/hora de software para um pacote Tx específico quando indicado para fazer isso pelo sistema operacional.
5 RxAll & TaggedTx: esse valor de enumeração corresponde à capacidade do driver de miniporto para gerar carimbos de data/hora de software para todos os pacotes durante o Rx e para um pacote Tx específico quando indicado para fazer isso pelo sistema operacional.

Observação

Se o driver de miniporto encontrar um valor sem suporte para o palavra-chave *SoftwareTimestamp, ele deverá desabilitar completamente a funcionalidade de carimbo de data/hora do software.