Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Usługa NDIS wystawia żądanie metody identyfikatora obiektu (OID) OID_SRIOV_BAR_RESOURCES w celu określenia zasobów pamięci przydzielonych do podstawowego rejestru adresów PCI Express (PCIe) (BAR) funkcji wirtualnej PCIe (VF).
Usługa NDIS wysyła żądanie tej metody OID do sterownika miniportu dla funkcji fizycznej PCIe karty sieciowej (PF). To żądanie metody identyfikatora OID jest wymagane dla sterowników miniportu PF, które obsługują interfejs wirtualizacji we/wy pojedynczego głównego (SR-IOV).
Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor zawiera następujące struktury:
Struktura NDIS_SRIOV_BAR_RESOURCES_INFO określająca VF i BAR, dla której sterownik miniportu PF zwraca informacje o zasobie.
Struktura CM_PARTIAL_RESOURCE_DESCRIPTOR zgodna ze strukturą NDIS_SRIOV_BAR_RESOURCES_INFO. Struktura CM_PARTIAL_RESOURCE_DESCRIPTOR zawiera informacje o zasobach pamięci przydzielonych do określonego paska.
Uwagi
Usługa NDIS wysyła żądanie metody OID OID_SRIOV_BAR_RESOURCES w celu uzyskania adresu fizycznego systemu i długości zasobów pamięci przydzielonych do baru VF. Przed uruchomieniem żądania metody OID usługa NDIS formatuje strukturę NDIS_SRIOV_BAR_RESOURCES_INFO w następujący sposób:
Usługa NDIS ustawia identyfikator VFId struktury NDIS_SRIOV_BAR_RESOURCES_INFO na identyfikator skojarzony z VF.
NDIS ustawia BarIndex składowej struktury NDIS_SRIOV_BAR_RESOURCES_INFO na indeks BAR dla określonego VF. Indeks BAR jest przesunięciem rejestru w tabeli BARs w przestrzeni konfiguracji PCI.
NDIS ustawia element BarResourcesOffset struktury NDIS_SRIOV_BAR_RESOURCES_INFO na przesunięcie w jednostkach bajtów od początku struktury NDIS_SRIOV_BAR_RESOURCES_INFO do struktury CM_PARTIAL_RESOURCE_DESCRIPTOR.
Uwaga overlying sterowników, takich jak sterowniki protokołu lub filtru, nie mogą wystawiać żądań metody OID OID_SRIOV_BAR_RESOURCES do sterownika miniport PF.
Gdy sterownik miniportu PF odbiera żądanie metody OID, sterownik zwraca zasoby dla określonego paska, formatując strukturę CM_PARTIAL_RESOURCE_DESCRIPTOR w InformationBuffer składowej struktury NDIS_OID_REQUEST. Sterownik formatuje strukturę CM_PARTIAL_RESOURCE_DESCRIPTOR z zasobami sprzętowymi systemu skojarzonymi z bar dla określonej VF.
Uwaga Sterownik musi sformatować strukturę dla typu zasobu CmResourceTypeMemory.
Kody stanu powrotu
Sterownik miniportu PF zwraca jeden z następujących kodów stanu dla żądania metody OID_SRIOV_BAR_RESOURCES.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie OID zostało ukończone pomyślnie. |
NDIS_STATUS_NOT_SUPPORTED |
Sterownik miniportu PF nie obsługuje interfejsu wirtualizacji we/wy pojedynczego katalogu głównego (SR-IOV) lub nie jest włączony do korzystania z interfejsu. |
NDIS_STATUS_INVALID_PARAMETER |
Co najmniej jeden z elementów członkowskich struktury NDIS_SRIOV_BAR_RESOURCES_INFO ma nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacji jest mniejszy niż (sizeof(NDIS_SRIOV_BAR_RESOURCES_INFO) + sizeof(CM_PARTIAL_RESOURCE_DESCRIPTOR). Sterownik miniportu PF musi ustawić DANE. METHOD_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
NDIS_STATUS_FAILURE |
Żądanie nie powiodło się z innych powodów. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |