OID_SRIOV_CURRENT_CAPABILITIES
Ein überlastender Treiber gibt eine OID-Abfrageanforderung (Object Identifier) von OID_SRIOV_CURRENT_CAPABILITIES aus, um die aktuellen SR-IOV-Funktionen (Single Root I/O Virtualization) eines Netzwerkadapters abzurufen.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf die NDIS_SRIOV_CAPABILITIES-Struktur .
Bemerkungen
Ab NDIS 6.30 stellen Miniporttreiber die aktivierten SR-IOV-Hardwarefunktionen auf dem Netzwerkadapter bereit, wenn die MiniportInitializeEx-Funktion aufgerufen wird. Der Treiber initialisiert eine NDIS_SRIOV_CAPABILITIES-Struktur mit den derzeit aktivierten SR-IOV-Hardwarefunktionen und legt den CurrentSriovCapabilities-Member 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.
Overlying-Protokoll- und Filtertreiber müssen keine OID-Abfrageanforderungen von OID_SRIOV_CURRENT_CAPABILITIES ausgeben. NDIS stellt die derzeit aktivierten SR-IOV-Funktionen eines Netzwerkadapters auf folgende Weise für diese Treiber bereit:
NDIS meldet die derzeit aktivierten SR-IOV-Funktionen eines zugrunde liegenden Netzwerkadapters an überlappende Protokolltreiber im SriovCapabilities-Member der NDIS_BIND_PARAMETERS-Struktur während des Bindungsvorgangs.
NDIS meldet die derzeit aktivierten SR-IOV-Funktionen eines zugrunde liegenden Netzwerkadapters, um filtertreiber im SriovCapabilities-Member der NDIS_FILTER_ATTACH_PARAMETERS-Struktur während des Anfügungsvorgangs zu übersteigen.
Zurückgeben von Statuscodes
NDIS verarbeitet die OID-Abfrageanforderung der OID_SRIOV_CURRENT_CAPABILITIES-Anforderung für Miniporttreiber. Die Treiber erhalten diese OID-Anforderung nicht.
Wenn NDIS die OID_SRIOV_CURRENT_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 nicht die SR-IOV-Schnittstelle (Single Root I/O Virtualization) oder ist nicht für die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. Der Miniporttreiber muss die DATEN festlegen. QUERY_INFORMATION. BytesNeeded-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) |