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á:
Habilite os recursos relevantes de carimbo de data/hora de hardware no hardware nic.
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,AllTransmitHwAllReceiveHweTaggedTransmitHw. 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.