OID_SRIOV_BAR_RESOURCES
NDIS vydává žádost o metodu identifikátoru objektu (OID) OID_SRIOV_BAR_RESOURCES k určení paměťových prostředků, které byly přiděleny základnímu registru adres PCI Express (PCIe) virtuální funkce PCIe (VF).
NDIS vydává tuto žádost o metodu OID pro ovladač miniportu pro fyzickou funkci PCIe (PF) síťového adaptéru. Tento požadavek na metodu OID je vyžadován pro ovladače miniportu PF, které podporují rozhraní jedno kořenové virtualizace vstupně-výstupních operací (SR-IOV).
InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na vyrovnávací paměť. Tato vyrovnávací paměť obsahuje následující struktury:
Struktura NDIS_SRIOV_BAR_RESOURCES_INFO, která určuje VF a BAR, pro které ovladač miniportu PF vrací informace o prostředcích.
Struktura CM_PARTIAL_RESOURCE_DESCRIPTOR, která se řídí strukturou NDIS_SRIOV_BAR_RESOURCES_INFO. Struktura CM_PARTIAL_RESOURCE_DESCRIPTOR obsahuje informace o prostředcích paměti, které byly přiděleny zadanému pruhu.
Poznámky
NDIS vydá žádost o metodu OID OID_SRIOV_BAR_RESOURCES k získání fyzické adresy systému a délky paměťových prostředků, které byly přiděleny do VF BAR. Před vydáním požadavku metody OID formátuje NDIS strukturu NDIS_SRIOV_BAR_RESOURCES_INFO následujícím způsobem:
NDIS nastaví VFId člen struktury NDIS_SRIOV_BAR_RESOURCES_INFO na identifikátor přidružený k VF.
NDIS nastaví BarIndex člen struktury NDIS_SRIOV_BAR_RESOURCES_INFO na index BAR pro zadaný VF. Index BAR je posun registru v tabulce BAR v konfiguračním prostoru PCI.
NDIS nastaví BarResourcesOffset člen struktury NDIS_SRIOV_BAR_RESOURCES_INFO na posun v jednotkách bajtů od začátku struktury NDIS_SRIOV_BAR_RESOURCES_INFO do struktury CM_PARTIAL_RESOURCE_DESCRIPTOR.
Poznámka: Přílišné ovladače, jako jsou ovladače protokolu nebo filtru, nemůžou vydávat požadavky metody OID OID_SRIOV_BAR_RESOURCES ovladači miniportu PF.
Když ovladač miniportu PF obdrží požadavek na metodu OID, ovladač vrátí prostředky pro zadaný panel formátováním struktury CM_PARTIAL_RESOURCE_DESCRIPTOR v rámci InformationBuffer člen struktury NDIS_OID_REQUEST. Ovladač formátuje strukturu CM_PARTIAL_RESOURCE_DESCRIPTOR se systémovými hardwarovými prostředky přidruženými k panelu pro zadaný VF.
Poznámka Ovladač musí formátovat strukturu pro typ prostředku CmResourceTypeMemory.
Návratové stavové kódy
Ovladač miniportu PF vrátí jeden z následujících stavových kódů pro požadavek metody OID_SRIOV_BAR_RESOURCES.
| Stavový kód | Popis |
|---|---|
NDIS_STATUS_SUCCESS |
Požadavek OID byl úspěšně dokončen. |
NDIS_STATUS_NOT_SUPPORTED |
Ovladač miniportu PF buď nepodporuje rozhraní jedno kořenové virtualizace vstupně-výstupních operací (SR-IOV), nebo není povoleno používat rozhraní. |
NDIS_STATUS_INVALID_PARAMETER |
Nejméně jeden člen struktury NDIS_SRIOV_BAR_RESOURCES_INFO má neplatné hodnoty. |
NDIS_STATUS_INVALID_LENGTH |
Vyrovnávací paměť informací je menší než (sizeof(NDIS_SRIOV_BAR_RESOURCES_INFO) + sizeof(CM_PARTIAL_RESOURCE_DESCRIPTOR). Ovladač miniportu PF musí nastavit DATA. METHOD_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti. |
NDIS_STATUS_FAILURE |
Žádost se nezdařila z jiných důvodů. |
Požadavky
Verze |
Podporováno v NDIS 6.30 a novějších verzích. |
Záhlaví |
Ntddndis.h (včetně Ndis.h) |