NDIS_PCI_DEVICE_CUSTOM_PROPERTIES 結構 (ntddndis.h)

發行項
03/01/2024

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。