OID_SRIOV_HARDWARE_CAPABILITIES
Ein Überlastungstreiber stellt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_SRIOV_HARDWARE_CAPABILITIES aus, um die Hardwarefunktionen der Single Root-E/A-Virtualisierung (Single Root E/O Virtualization, SR-IOV) des Netzwerkadapters abzurufen.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf die NDIS_SRIOV_CAPABILITIES-Struktur .
Bemerkungen
Die NDIS_SRIOV_CAPABILITIES-Struktur enthält Informationen zu den Hardwarefunktionen des Netzwerkadapters, z. B. ob der Adapter SR-IOV unterstützt und ob der Miniporttreiber die PCI Express (PCIe) Physical Function (PF) oder die Virtuelle Funktion (VF) des Adapters verwaltet. Zu diesen Funktionen können die Hardwarefunktionen gehören, die derzeit von den INF-Dateieinstellungen oder über die Seite Erweiterte Eigenschaften deaktiviert sind.
Hinweis Alle SR-IOV-Funktionen des Netzwerkadapters werden über eine OID-Abfrageanforderung von OID_SRIOV_HARDWARE_CAPABILITIES zurückgegeben, unabhängig davon, ob eine Funktion aktiviert oder deaktiviert ist.
Ab NDIS 6.30 stellen Miniporttreiber die SR-IOV-Hardwarefunktionen bereit, wenn die MiniportInitializeEx-Funktion aufgerufen wird. Der Treiber initialisiert eine NDIS_SRIOV_CAPABILITIES-Struktur mit den SR-IOV-Hardwarefunktionen und legt das HardwareSriovCapabilities-Element der NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur auf einen Zeiger auf die NDIS_SRIOV_CAPABILITIES-Struktur fest. Der Miniporttreiber ruft dann die NdisMSetMiniportAttributes-Funktion auf und legt den MiniportAttributes-Parameter auf einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur fest.
Rückgabestatuscodes
NDIS verarbeitet die OID-Abfrageanforderung der OID_SRIOV_HARDWARE_CAPABILITIES Anforderung für Miniporttreiber. Die Treiber erhalten diese OID-Anforderung nicht.
Wenn NDIS die OID_SRIOV_HARDWARE_CAPABILITIES-Anforderung verarbeitet, gibt es einen der folgenden status Codes zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt entweder die SR-IOV-Schnittstelle (Single Root E/O Virtualization) nicht oder ist für die Verwendung der Schnittstelle nicht aktiviert. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. Der Miniporttreiber muss die DATA festlegen. QUERY_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_FAILURE |
Die Anforderung ist aus anderen Gründen fehlgeschlagen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |