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 指定為NDIS_OBJECT_TYPE_DEFAULT的 Type 成員、將 Revision 成員設定為 NDIS_OBJECT_TYPE_PCI_DEVICE_CUSTOM_PROPERTIES_REVISION_1，並將 Size 成員設定為 sizeof (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快速裝置。 請參閱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) |