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