estrutura NDIS_PCI_DEVICE_CUSTOM_PROPERTIES (ntddndis.h)

Artigo
03/01/2024

A estrutura NDIS_PCI_DEVICE_CUSTOM_PROPERTIES define o tipo e a velocidade do barramento PCI em que uma NIC está sendo executada.

Sintaxe

typedef struct _NDIS_PCI_DEVICE_CUSTOM_PROPERTIES {
  NDIS_OBJECT_HEADER Header;
  UINT32             DeviceType;
  UINT32             CurrentSpeedAndMode;
  UINT32             CurrentPayloadSize;
  UINT32             MaxPayloadSize;
  UINT32             MaxReadRequestSize;
  UINT32             CurrentLinkSpeed;
  UINT32             CurrentLinkWidth;
  UINT32             MaxLinkSpeed;
  UINT32             MaxLinkWidth;
  UINT32             PciExpressVersion;
  UINT32             InterruptType;
  UINT32             MaxInterruptMessages;
} NDIS_PCI_DEVICE_CUSTOM_PROPERTIES, *PNDIS_PCI_DEVICE_CUSTOM_PROPERTIES;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_PCI_DEVICE_CUSTOM_PROPERTIES. O NDIS define o membro Type da estrutura especificada como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision para NDIS_OBJECT_TYPE_PCI_DEVICE_CUSTOM_PROPERTIES_REVISION_1 e o membro Size como sizeof(NDIS_PCI_DEVICE_CUSTOM_PROPERTIES).

DeviceType

O tipo de dispositivo PCI. Por exemplo, convencional, PCI-X, PCI-E e assim por diante. Consulte as definições para DevProp_PciDevice_DeviceType_xxx em pciprop.h.

CurrentSpeedAndMode

A velocidade e o modo de dispositivos PCI ou PCI-X convencionais. Para dispositivos PCI convencionais, consulte as definições para DevProp_PciDevice_CurrentSpeedAndMode_Pci_Conventional_xxx. Para dispositivos PCI-X, consulte as definições para DevProp_PciDevice_CurrentSpeedAndMode_Pci_X_xxx. Essa propriedade é válida somente para dispositivos PCI e PCI-X convencionais.

CurrentPayloadSize

O tamanho atual da carga na camada de transação de um dispositivo PCI Express. Consulte definições para DevProp_PciExpressDevice_PayloadOrRequestSize_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

MaxPayloadSize

O tamanho máximo da carga na camada de transação compatível com um dispositivo PCI Express. Consulte definições para DevProp_PciExpressDevice_PayloadOrRequestSize_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

MaxReadRequestSize

O tamanho máximo da solicitação de leitura para um dispositivo PCI Express. Consulte definições para DevProp_PciExpressDevice_PayloadOrRequestSize_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

CurrentLinkSpeed

A velocidade do link atual para o dispositivo. Essa propriedade é aplicável a um dispositivo PCI Express. Consulte as definições para DevProp_PciExpressDevice_LinkSpeed_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

CurrentLinkWidth

A largura do link atual do dispositivo. Essa propriedade é aplicável a um dispositivo PCI express. Consulte as definições para DevProp_PciExpressDevice_LinkWidth_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

MaxLinkSpeed

A velocidade máxima de link de um link expresso para um dispositivo PCI Express. Consulte as definições para DevProp_PciExpressDevice_LinkSpeed_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

MaxLinkWidth

A largura máxima do link implementada por um link expresso para um dispositivo PCI Express. Consulte as definições para DevProp_PciExpressDevice_LinkWidth_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

PciExpressVersion

A versão de especificação na qual um dispositivo PCI Express foi criado. Consulte as definições para DevProp_PciExpressDevice_Spec_Version_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

InterruptType

O suporte de hardware para interrupções no dispositivo PCI Express. Consulte as definições para DevProp_PciDevice_InterruptType_xxx. Essa propriedade é válida somente para dispositivos PCI Express.

MaxInterruptMessages

O número de interrupções de mensagem que um dispositivo PCI Express dá suporte no hardware. Consulte a definição para DevProp_PciDevice_InterruptMessageMaximum. Essa propriedade é válida somente para dispositivos PCI Express que dão suporte a interrupções de mensagens.

Comentários

Alguns adaptadores de miniporta de alto desempenho podem ajustar a configuração de hardware e a alocação de recursos com base no tipo e na velocidade do barramento PCI em que a NIC está sendo executada. Para fornecer drivers de miniporta com essas informações durante a inicialização, o NDIS consulta as propriedades PCI personalizadas dos adaptadores PCI e fornece os resultados no membro PciDeviceCustomProperties do NDIS_MINIPORT_INIT_PARAMETERS estrutura. O tipo e a velocidade do barramento PCI também estão disponíveis por meio do OID_GEN_PCI_DEVICE_CUSTOM_PROPERTIES Solicitação OID e o GUID_NDIS_GEN_PCI_DEVICE_CUSTOM_PROPERTIES GUID WMI.