NDIS_PCI_DEVICE_CUSTOM_PROPERTIES-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_PCI_DEVICE_CUSTOM_PROPERTIES-Struktur definiert den Typ und die Geschwindigkeit des PCI-Busses, auf dem eine NIC ausgeführt wird.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_PCI_DEVICE_CUSTOM_PROPERTIES-Struktur. NDIS legt das Type-Element der Struktur fest, das Header für NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NDIS_OBJECT_TYPE_PCI_DEVICE_CUSTOM_PROPERTIES_REVISION_1 und das Size-Element auf sizeof(NDIS_PCI_DEVICE_CUSTOM_PROPERTIES).

DeviceType

Der PCI-Gerätetyp. Beispielsweise konventionell, PCI-X, PCI-E usw. Weitere Informationen finden Sie in den Definitionen für DevProp_PciDevice_DeviceType_xxx in pciprop.h.

CurrentSpeedAndMode

Geschwindigkeit und Modus herkömmlicher PCI- oder PCI-X-Geräte. Informationen zu herkömmlichen PCI-Geräten finden Sie in den Definitionen für DevProp_PciDevice_CurrentSpeedAndMode_Pci_Conventional_xxx. Informationen zu PCI-X-Geräten finden Sie in den Definitionen für DevProp_PciDevice_CurrentSpeedAndMode_Pci_X_xxx. Diese Eigenschaft ist nur für herkömmliche PCI- und PCI-X-Geräte gültig.

CurrentPayloadSize

Die aktuelle Nutzlastgröße in der Transaktionsschicht für ein PCI Express-Gerät. Siehe Definitionen für DevProp_PciExpressDevice_PayloadOrRequestSize_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

MaxPayloadSize

Die maximale Nutzlastgröße in der Transaktionsschicht, die von einem PCI Express-Gerät unterstützt wird. Siehe Definitionen für DevProp_PciExpressDevice_PayloadOrRequestSize_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

MaxReadRequestSize

Die maximale Leseanforderungsgröße für ein PCI Express-Gerät. Siehe Definitionen für DevProp_PciExpressDevice_PayloadOrRequestSize_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

CurrentLinkSpeed

Die aktuelle Verbindungsgeschwindigkeit für das Gerät. Diese Eigenschaft gilt für ein PCI Express-Gerät. Weitere Informationen finden Sie in den Definitionen für DevProp_PciExpressDevice_LinkSpeed_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

CurrentLinkWidth

Die aktuelle Linkbreite des Geräts. Diese Eigenschaft gilt für ein PCI-Express-Gerät. Weitere Informationen finden Sie in den Definitionen für DevProp_PciExpressDevice_LinkWidth_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

MaxLinkSpeed

Die maximale Verbindungsgeschwindigkeit eines Expresslinks für ein PCI Express-Gerät. Weitere Informationen finden Sie in den Definitionen für DevProp_PciExpressDevice_LinkSpeed_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

MaxLinkWidth

Die maximale Linkbreite, die von einem Expresslink für ein PCI Express-Gerät implementiert wird. Weitere Informationen finden Sie in den Definitionen für DevProp_PciExpressDevice_LinkWidth_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

PciExpressVersion

Die Spezifikationsversion, in der ein PCI-Express-Gerät erstellt wurde. Weitere Informationen finden Sie in den Definitionen für DevProp_PciExpressDevice_Spec_Version_xxx. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

InterruptType

Die Hardwareunterstützung für Interrupts auf dem PCI Express-Gerät. Sehen Sie sich die Definitionen für DevProp_PciDevice_InterruptType_xxx an. Diese Eigenschaft ist nur für PCI Express-Geräte gültig.

MaxInterruptMessages

Die Anzahl der Nachrichtenunterbrechungen, die ein PCI Express-Gerät in der Hardware unterstützt. Weitere Informationen finden Sie in der Definition für DevProp_PciDevice_InterruptMessageMaximum. Diese Eigenschaft ist nur für PCI Express-Geräte gültig, die Nachrichtenunterbrechungen unterstützen.

Hinweise

Einige Hochleistungs-Miniportadapter können die Hardwarekonfiguration und Ressourcenzuordnung basierend auf dem Typ und der Geschwindigkeit des PCI-Busses anpassen, auf dem die NIC ausgeführt wird. Um Miniporttreibern diese Informationen während der Initialisierung bereitzustellen, fragt NDIS die benutzerdefinierten PCI-Eigenschaften von PCI-Adaptern ab und stellt die Ergebnisse im PciDeviceCustomProperties-Member des NDIS_MINIPORT_INIT_PARAMETERS Struktur. Der Typ und die Geschwindigkeit des PCI-Busses sind auch über die OID_GEN_PCI_DEVICE_CUSTOM_PROPERTIES OID-Anforderung und die GUID_NDIS_GEN_PCI_DEVICE_CUSTOM_PROPERTIES WMI-GUID.