NDIS_PCI_DEVICE_CUSTOM_PROPERTIES 结构 (ntddndis.h)

NDIS_PCI_DEVICE_CUSTOM_PROPERTIES 结构定义运行 NIC 的 PCI 总线的类型和速度。

语法

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;

成员

Header

NDIS_PCI_DEVICE_CUSTOM_PROPERTIES 结构的NDIS_OBJECT_HEADER结构。 NDIS 将 Header 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT，将 Revision 成员设置为 NDIS_OBJECT_TYPE_PCI_DEVICE_CUSTOM_PROPERTIES_REVISION_1，将 Size 成员设置为 size of (NDIS_PCI_DEVICE_CUSTOM_PROPERTIES) 。

DeviceType

PCI 设备类型。 例如，常规、PCI-X、PCI-E 等。 请参阅 pciprop.h 中DevProp_PciDevice_DeviceType_xxx的定义。

CurrentSpeedAndMode

传统 PCI 或 PCI-X 设备的速度和模式。 对于传统 PCI 设备，请参阅DevProp_PciDevice_CurrentSpeedAndMode_Pci_Conventional_xxx的定义。 对于 PCI-X 设备，请参阅DevProp_PciDevice_CurrentSpeedAndMode_Pci_X_xxx的定义。 此属性仅适用于传统 PCI 和 PCI-X 设备。

CurrentPayloadSize

PCI Express 设备的事务层中的当前有效负载大小。 请参阅DevProp_PciExpressDevice_PayloadOrRequestSize_xxx的定义。 此属性仅对 PCI Express 设备有效。

MaxPayloadSize

PCI Express 设备支持的事务层中的最大有效负载大小。 请参阅DevProp_PciExpressDevice_PayloadOrRequestSize_xxx的定义。 此属性仅对 PCI Express 设备有效。

MaxReadRequestSize

PCI Express 设备的最大读取请求大小。 请参阅DevProp_PciExpressDevice_PayloadOrRequestSize_xxx的定义。 此属性仅对 PCI Express 设备有效。

CurrentLinkSpeed

设备的当前链接速度。 此属性适用于 PCI Express 设备。 请参阅DevProp_PciExpressDevice_LinkSpeed_xxx的定义。 此属性仅对 PCI Express 设备有效。

CurrentLinkWidth

设备的当前链接宽度。 此属性适用于 PCI Express 设备。 请参阅DevProp_PciExpressDevice_LinkWidth_xxx的定义。 此属性仅对 PCI Express 设备有效。

MaxLinkSpeed

PCI Express 设备的快速链接的最大链接速度。 请参阅DevProp_PciExpressDevice_LinkSpeed_xxx的定义。 此属性仅对 PCI Express 设备有效。

MaxLinkWidth

由 PCI Express 设备的快速链接实现的最大链接宽度。 请参阅DevProp_PciExpressDevice_LinkWidth_xxx的定义。 此属性仅对 PCI Express 设备有效。

PciExpressVersion

生成 PCI Express 设备的规范版本。 请参阅DevProp_PciExpressDevice_Spec_Version_xxx的定义。 此属性仅对 PCI Express 设备有效。

InterruptType

PCI Express 设备上中断的硬件支持。 请参阅DevProp_PciDevice_InterruptType_xxx的定义。 此属性仅对 PCI Express 设备有效。

MaxInterruptMessages

PCI Express 设备在硬件中支持的消息中断数。 请参阅DevProp_PciDevice_InterruptMessageMaximum的定义。 此属性仅适用于支持消息中断的 PCI Express 设备。

注解

某些高性能微型端口适配器可以根据运行 NIC 的 PCI 总线的类型和速度调整硬件配置和资源分配。 若要在初始化期间为微型端口驱动程序提供此信息，NDIS 会查询 PCI 适配器的自定义 PCI 属性，并在 PciDeviceCustomProperties 成员中提供结果 NDIS_MINIPORT_INIT_PARAMETERS 结构。 PCI 总线的类型和速度也可通过 OID_GEN_PCI_DEVICE_CUSTOM_PROPERTIES OID 请求和 GUID_NDIS_GEN_PCI_DEVICE_CUSTOM_PROPERTIES WMI GUID。

要求

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
标头	ntddndis.h (包括 Ndis.h)

另请参阅

GUID_NDIS_GEN_PCI_DEVICE_CUSTOM_PROPERTIES

NDIS_MINIPORT_INIT_PARAMETERS

NDIS_OBJECT_HEADER

OID_GEN_PCI_DEVICE_CUSTOM_PROPERTIES