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) |