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.
Nadmierny sterownik lub aplikacja trybu użytkownika wystawia żądanie metody identyfikatora obiektu (OID) OID_NIC_SWITCH_ENUM_VPORTS w celu uzyskania tablicy. Każdy element w tablicy określa atrybuty portu wirtualnego (VPort), który został utworzony na przełączniku karty sieciowej karty sieciowej.
Po pomyślnym powrocie z tego żądania zapytania OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu zawierającego następujące elementy:
Struktura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, która definiuje liczbę elementów w tablicy.
Tablica struktur NDIS_NIC_SWITCH_VPORT_INFO. Każda z tych struktur zawiera informacje o wirtualnym porcie na przełączniku karty sieciowej karty sieciowej.
Uwaga Jeśli na karcie sieciowej nie utworzono żadnych wirtualnych portów wirtualnych, sterownik ustawia NumElements składową struktury NDIS_NIC_SWITCH_VPORT_INFO_ARRAY na zero i nie są zwracane żadne struktury NDIS_NIC_SWITCH_VPORT_INFO.
Uwagi
Nadmierne sterowniki i aplikacje w trybie użytkownika wystawiają żądania zapytań OID OID_NIC_SWITCH_ENUM_VPORTS w celu wyliczenia wirtualnych portów przydzielonych na przełączniku karty sieciowej karty sieciowej.
Zanim sterownik lub aplikacja wysyła żądanie OID, musi zainicjować strukturę NDIS_NIC_SWITCH_VPORT_INFO_ARRAY przekazywaną wraz z żądaniem. Sterownik lub aplikacja musi przestrzegać tych wytycznych podczas inicjowania struktury NDIS_NIC_SWITCH_VPORT_INFO_ARRAY:
Jeśli flaga NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH jest ustawiona w elemencie członkowskim Flags, informacje są zwracane dla wszystkich wirtualnych portów utworzonych na określonym przełączniku karty sieciowej. Przełącznik karty sieciowej jest określony przez SwitchId składowej tej struktury.
Uwaga Począwszy od systemu Windows Server 2012, interfejs SR-IOV obsługuje tylko domyślny przełącznik kart sieciowych na karcie sieciowej. Niezależnie od flag ustawionych w elemencie flagi należy ustawić element członkowski switchId na wartość NDIS_DEFAULT_SWITCH_ID.
Jeśli flaga NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION jest ustawiona w elemencie flagi, informacje są zwracane dla wszystkich wirtualnych portów wirtualnych dołączonych do określonej funkcji fizycznej PCI Express (PCIe) (PF) lub funkcji wirtualnej (VF) na karcie sieciowej. Pf lub VF jest określony przez element członkowski AttachedFunctionId tej struktury.
Jeśli element członkowski AttachedFunctionId jest ustawiony na NDIS_PF_FUNCTION_ID, zostaną zwrócone informacje dla wszystkich wirtualnych portów, w tym domyślnego wirtualnegoportu, które są dołączone do pf karty sieciowej. Jeśli element członkowski AttachedFunctionId jest ustawiony na prawidłowy identyfikator VF, informacje są zwracane dla wszystkich wirtualnych portów wirtualnych do określonego VF.
Uwaga Począwszy od systemu Windows Server 2012, tylko jeden niezdefault VPort może być dołączony do VF. Do pf można jednak dołączyć wiele wirtualnych portów wirtualnych (w tym domyślny port VPort).
Jeśli element członkowski flagi jest ustawiony na zero, informacje są zwracane dla wszystkich wirtualnych portów wirtualnych dołączonych do pf lub VF na karcie sieciowej. W tym przypadku wartości SwitchId i AttachedFunctionId są ignorowane.
Aby uzyskać więcej informacji, zobacz Wyliczanie portów wirtualnych na karcie sieciowej.
Kody stanu powrotu
Usługa NDIS obsługuje żądanie metody OID żądania OID_NIC_SWITCH_ENUM_VPORTS dla sterowników miniportu. Sterowniki nie będą wystawiane tego żądania identyfikatora OID.
Gdy usługa NDIS obsługuje żądanie OID_NIC_SWITCH_ENUM_VPORTS, zwraca jeden z następujących kodów stanu:
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie OID zostało ukończone pomyślnie. |
NDIS_STATUS_NOT_SUPPORTED |
Sterownik miniportu 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_NIC_SWITCH_VF_INFO_ARRAY ma nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacyjny był zbyt krótki. Usługa NDIS ustawia DATA. 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) |